@hellocoop/管理员-MCP（测试版）
用于创建和管理模型上下文协议（MCP）的服务器 你好（注：原文中的“Hellō”是一个拼写错误，正确的拼写应为“Hello”，但在此按照原文进行翻译） 应用程序。
🚧 测试版状态这个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不同， 每次操作都会自动包含您的完整开发者上下文 - 个人资料、团队和应用程序 - 使其非常适合人工智能助手。
📖 如需详细的使用说明、示例和故障排除方法，请访问： hello.dev/docs/admin-mcp 翻译为中文是：“hello.dev/文档/管理员-MCP（多云平台/管理控制面板）”。不过，这里的“MCP”具体含义可能根据上下文有所不同，它可能代表“Multi-Cloud Platform（多云平台）”、“Management Control Panel（管理控制面板）”或其他相关术语。在没有具体上下文的情况下，通常可以将其翻译为较为通用的“管理控制面板”或保持原样以体现其专业性
特点/特性
- 🏢 上下文感知操作每次调用工具时，都会自动包含您当前的开发者资料、团队和应用程序，以实现无缝上下文集成
- 📱 统一应用程序管理单一强大的工具，满足所有应用操作需求（创建、读取、更新、管理密钥、处理标识）
- 🔐 安全的OAuth集成基于浏览器的认证，使用JWT令牌验证
- 🌐 多交通方式支持支持stdio（本地）和HTTP（远程）MCP传输方式
- 📊 内置分析工具使用追踪与性能监控以优化（效果/表现）
- 🎨 标识管理上传带有自动亮色/暗色主题支持的标志
- ⚙️ 环境灵活性可配置的域和管理服务器
可用工具
🎯 核心工具：
hello_manage_app- 所有应用程序管理的主要工具
- 行动: create， read， update， create_secret， update_logo_from_data， update_logo_from_url - 总是包含您当前的个人资料、团队以及每次回复中的应用程序 - 自动上下文如果未指定团队，则自动使用默认团队 - 智能默认设置如果未提供应用名称，则根据您的个人资料生成应用名称
主要优势
🔄 始终贴合上下文与传统API不同，每个工具响应都包含您的完整开发者上下文：
- 您的用户资料（姓名、电子邮件、头像）
- 您所有团队/组织中的角色
- 您所有与团队关联的应用程序
- 当前团队和应用状态
这意味着在操作之间你永远不会丢失上下文——这对于需要理解你完整开发环境的人工智能助手来说非常完美。
工具操作与响应结构
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数据上传logo
- 支持浅色/深色主题
- 带有Logo URL的应用程序自动更新功能
- 返回值：
{ profile, application, update_result, action_result }
🔗（此符号在中文中通常表示链接，但无具体含义，可直接保留或根据上下文替换为“链接”等词汇） update_logo_from_url - 从URL上传logo
- 从提供的URL获取并上传
- 支持浅色/深色主题
- 返回：
{ profile, application, update_result, action_result }
每个回复都包含您的完整个人资料信息这使得它非常适合那些需要保持对您的开发环境意识的人工智能助手。
可用资源
- Hellō 文档说明 - 完整的集成文档
- 你好，快速入门指南 - 针对特定框架的设置指南
- 你好，按钮们 - 登录按钮实现指南
- 你好，斯科斯（或根据具体语境可译为“各位斯科斯用户”等） - 可用的作用域和声明引用
- “Hellō Wallet API” 钱包API参考文档
- “Hellō”标志设计指南 - 创建符合主题标识的全面指南
环境变量
HELLO_DOMAIN覆盖默认域（默认为hello.coop）HELLO_ADMIN覆盖管理服务器URL（默认为https://admin.hello.coop）
贡献与发展
我们期待您的反馈！ 这个MCP服务器目前处于测试阶段，我们正在根据实际使用情况积极对其进行改进。
如何贡献（或：如何参与贡献）
- 🐞 报告问题： - 发现了一个错误或有功能需求？
- 🔧 提交拉取请求（Pull Request）: - 帮助我们改进服务器
- 💬 参与讨论： 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