Admin MCP

🚀 @hellocoop/admin-mcp (BETA)

@hellocoop/admin-mcp (BETA) 是一個用於創建和管理 Hellō 應用程序的模型上下文協議（MCP）服務器。藉助它，你可以通過AI助手直接創建和管理Hellō應用，操作時還會自動包含完整的開發者上下文信息。

⚠️ 重要提示

此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）

🤝 貢獻與開發

如何貢獻

• 🐛 報告問題：GitHub問題 - 如果你發現了漏洞或有功能請求，請在此報告。
• 🔧 提交拉取請求：GitHub拉取請求 - 幫助我們改進服務器。
• 💬 參與討論：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