P 69 Branch Monkey MCP

🚀 Branch Monkey MCP 服務器

Branch Monkey MCP（模型上下文協議）服務器用於 Branch Monkey，它能將 Claude Code 連接到你的任務管理和團隊協作平臺。

🚀 快速開始

將以下內容添加到你項目的 .mcp.json 文件中：

{
  "mcpServers": {
    "branch-monkey-cloud": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/gneyal/p_69_branch_monkey_mcp.git", "branch-monkey-mcp"],
      "env": {
        "BRANCH_MONKEY_API_URL": "https://p-63-branch-monkey.pages.dev"
      }
    }
  }
}

重啟 Claude Code。首次使用時，會自動打開一個瀏覽器窗口供你登錄並批准該設備。

✨ 主要特性

• 無需 API 密鑰：通過瀏覽器批准進行身份驗證
• 自動存儲令牌：令牌存儲在 ~/.branch-monkey/token.json 文件中
• 任務管理：創建、更新和跟蹤任務
• 團隊協作：與團隊成員共享任務
• 提示跟蹤：將提示與任務關聯起來

📚 詳細文檔

可用工具

狀態與認證

• monkey_status：獲取連接狀態
• monkey_login：強制重新認證（在認證出現問題時使用）
• monkey_logout：清除認證令牌

項目與組織

• monkey_project_list：列出你所在組織的所有項目
• monkey_project_focus：將焦點設置到特定項目
• monkey_project_clear：清除項目焦點
• monkey_org_list：列出你有權限訪問的組織

任務

• monkey_task_list：列出所有任務
• monkey_task_create：創建新任務
• monkey_task_update：更新任務
• monkey_task_delete：刪除任務
• monkey_task_work：開始處理任務
• monkey_task_log：記錄任務進度
• monkey_task_complete：將任務標記為已完成
• monkey_task_search：搜索任務
• monkey_get_recent_tasks：獲取最近處理的任務
• monkey_auto_resume：自動檢測相關任務

版本

• monkey_version_list：列出版本
• monkey_version_create：創建版本

團隊

• monkey_team_list：列出團隊成員
• monkey_team_add：添加團隊成員

機器

• monkey_machine_list：列出機器
• monkey_machine_create：創建機器

故障排除

認證問題

如果你在連接時遇到問題：

1. 使用 monkey_login：通過瀏覽器強制重新認證
2. 檢查令牌文件：令牌文件存儲在 ~/.branch-monkey/token.json
3. 清除並重試：使用 monkey_logout，然後重啟 Claude Code
4. 檢查網絡：確保你可以訪問 https://p-63-branch-monkey.pages.dev

首次設置

首次使用時：

1. 會自動打開一個瀏覽器窗口
2. 登錄到 Branch Monkey（或創建一個賬戶）
3. 選擇你要連接的組織
4. 當提示時，批准該設備
5. 返回 Claude Code，此時你已連接成功！

連接成功後，使用 monkey_project_list 查看可用項目，並使用 monkey_project_focus <id> 選擇一個項目。

📦 安裝指南

要求

• Python 3.10 及以上版本
• uv 包管理器

📄 許可證

本項目採用 MIT 許可證。