admin-mcp

@hellocoop/admin-mcp（BETA）

用于创建和管理 Hellō 应用的模型上下文协议（MCP）服务。

🚧 BETA 状态：此 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ō Wallet API - Wallet API 参考文档
• Hellō 徽标设计指南 - 创建适合主题的徽标的综合指南

环境变量

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

贡献与开发

我们期待你的反馈！ 此 MCP 服务仍处于测试阶段，我们正在根据实际使用情况积极改进。

如何贡献

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

本地开发

本地开发和测试：

# Clone the repository
git clone https://github.com/hellocoop/admin-mcp
cd admin-mcp

# Install dependencies
npm install

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

本地开发（Node.js）：

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

测试

运行完整的测试套件：

# Run all automated tests
npm test