@hellocoop/admin-mcp (BETA)

用于创建和管理 Hellō 应用程序的 Model Context Protocol (MCP) 服务器。

🚧 测试版状态：此 MCP 服务器目前处于测试阶段。我们正在积极寻求反馈并欢迎贡献！请报告问题、提出改进建议或提交拉取请求以帮助我们改进开发者体验。

快速安装

📖 完整文档及安装指南

快速配置

将以下配置之一复制到您的 MCP 客户端设置中：

NPM 包（最新）：

{
  "hello-admin-stdio": {
    "command": "npx",
            "args": ["-y", "@hellocoop/admin-mcp@latest"],
    "type": "stdio"
  }
}

HTTP 运输（远程）：

{
  "hello-admin-http": {
          "url": "https://admin-mcp.hello.coop/",
    "type": "http"
  }
}

📖 查看本地开发设置 以从源代码运行

使用方法

此 MCP 服务器提供了一个强大的单一工具（hello_manage_app），让您能够直接从您的AI助手创建和管理 Hellō 应用程序。与传统API不同，每个操作都会自动包含您的完整开发者上下文——个人资料、团队和应用程序——使其非常适合AI助手。

📖 有关详细使用说明、示例和故障排除，请访问：hello.dev/docs/admin-mcp

功能

• 🏢 上下文感知操作：每次工具调用都会自动包含您的当前开发者个人资料、团队和应用程序，实现无缝上下文
• 📱 统一的应用程序管理：一个强大的工具用于所有应用操作（创建、读取、更新、密钥、图标）
• 🔐 安全的OAuth集成：基于浏览器的身份验证，带有JWT令牌验证
• 🌐 多种传输支持：支持stdio（本地）和HTTP（远程）MCP传输
• 📊 内置分析：使用跟踪和性能监控以优化
• 🎨 图标管理：上传图标时自动支持浅色和深色主题
• ⚙️ 环境灵活性：可配置的域名和管理服务器

可用工具

🎯 核心工具：

• hello_manage_app - 所有应用程序管理的主要工具
  • 动作：create, read, update, create_secret, update_logo_from_data, update_logo_from_url
  • 始终包含：在每个响应中都包含您当前的个人资料、团队和应用程序
  • 自动上下文：如果未指定，则自动使用默认团队
  • 智能默认值：如果没有提供，会根据您的个人资料生成应用程序名称

主要优势

🔄 始终在上下文中：与传统API不同，每个工具响应都会包括您的完整开发者上下文：

• 您的用户个人资料（姓名、电子邮件、图片）
• 所有您的团队/组织及其角色
• 所有您的应用程序及其团队关联
• 当前团队和应用程序状态

这意味着您在操作之间不会丢失上下文——对于需要理解您完整开发环境的AI助手来说，这是完美的。

工具动作及响应结构

hello_manage_app 动作：

📝 create - 创建新的应用程序

• 如果不存在，则自动生成团队
• 根据您的个人资料创建智能默认名称
• 返回：{ profile, application, action_result }

👁️ read - 读取应用程序详情

• 不带 client_id：返回您的完整个人资料上下文
• 带 client_id：返回个人资料+特定应用程序
• 返回：{ profile, application?, action_result }

✏️ update - 更新应用程序设置

• 修改任何应用程序属性
• 返回：{ profile, application, action_result }

🔑 create_secret - 生成客户端密钥

• 创建安全的OAuth客户端密钥
• 返回：{ profile, application, client_secret, action_result }

🎨 update_logo_from_data - 从base64数据上传图标

• 支持浅色和深色主题
• 自动更新应用程序图标URL
• 返回：{ profile, application, update_result, action_result }

🔗 update_logo_from_url - 从URL上传图标

• 从提供的URL获取并上传
• 支持浅色和深色主题
• 返回：{ profile, application, update_result, action_result }

每个响应都包含您的完整个人资料上下文，使其非常适合需要了解您开发环境的AI助手。

可用资源

• Hellō 文档 - 完整的集成文档
• Hellō 快速入门 - 框架特定的设置指南
• Hellō 按钮 - 登录按钮实现指南
• Hellō 范围 - 可用范围和声明参考
• Hellō 钱包API - 钱包API参考文档
• Hellō 图标设计指导 - 全面的创建适合主题图标的指南

环境变量

• HELLO_DOMAIN：覆盖默认域名（默认为 hello.coop）
• HELLO_ADMIN：覆盖管理服务器URL（默认为 https://admin.hello.coop）

贡献与发展

我们希望得到您的反馈！ 此 MCP 服务器正处于测试阶段，并且我们正根据实际使用情况积极改进它。

如何贡献

• 🐛 报告问题：GitHub Issues - 发现了错误或有功能请求？
• 🔧 提交拉取请求：GitHub PRs - 帮助我们改进服务器
• 💬 加入讨论：Discord - 分享反馈并获得帮助

本地开发

为了本地开发和测试：

# 克隆仓库
git clone https://github.com/hellocoop/admin-mcp
cd admin-mcp

# 安装依赖
npm install

然后配置您的AI客户端以运行本地版本

本地开发（Node.js）：

{
  "hello-admin-local": {
    "command": "node",
            "args": ["path/to/HelloCoop/admin-mcp/src/stdio.js"],
    "type": "stdio"
  }
}

测试

运行全面的测试套件：

# 运行所有自动化测试
npm test