使用说明内容（Markdown格式）

项目简介

• Branch Monkey MCP Server 是一个用 Python 实现的 MCP 服务器，用于 Claude Code 与 Branch Monkey Cloud 的集成。它通过 MCP 协议向大型语言模型提供任务管理、资源访问、工具执行等能力，并与 Branch Monkey 的云端 API 交互以完成相应操作。

主要功能点

• 提供一组可通过 MCP 调用的工具接口，如获取状态、列出/创建/更新任务、任务日志、版本、团队成员、机器等。
• 与 Branch Monkey Cloud 的 REST API 互动，实现任务创建、更新、日志记录、完成等操作。
• 集成设备码(flow) 用户认证流程：首次使用时通过浏览器完成设备授权，并将访问令牌缓存到本地。
• 会话与上下文跟踪：支持在特定会话中自动记录工具使用与任务上下文，便于后续溯源与上下文一致性。
• 通过 mcp.server.FastMCP 提供 MCP 服务入口，默认可与 CLI/IDE 的 MCP 客户端进行 JSON-RPC 通信。

安装步骤

• 环境要求：Python 3.10 及以上
• 安装依赖（示例）：pip install mcp requests urllib3
• 获取代码并进入目录：
  • 克隆或下载代码到本地
  • 进入包含 branch_monkey_mcp/server.py 的目录
• 启动服务器（示例方式，具体可按你们的运行环境调整）：
  • 直接运行：python -m branch_monkey_mcp.server
  • 或直接执行 server.py：python branch_monkey_mcp/server.py
• 运行时需要提供 Configuration Environment
  • BRANCH_MONKEY_API_URL：Branch Monkey Cloud 的 API 基础地址
  • 第一次运行会引导浏览器完成设备授权，授权后 token 将被缓存以备后续使用

服务器配置 注意：MCP 客户端在连接服务器前，需要提供一个配置，描述服务器名称、启动命令及参数等信息。本仓库的示例配置如下（为明确而给出 JSON 形式的配置示例，便于在 MCP 客户端使用时直接查看要填的项）： { "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" } // 说明：通过该命令启动 MCP 服务器，env 中需要填写 Branch Monkey 的 API 基础地址 } } 基本使用方法

• 启动后，依据 MCP 客户端的需求，向服务器发送 JSON-RPC 请求来调用各个工具（如 monkey_task_list、monkey_task_create 等）。
• 使用设备码授权后获得的令牌将用于对 Branch Monkey Cloud 的 API 请求。
• 可以通过 monkey_status 等工具快速查看当前连接状态和数据信息。
• 如需退出认证或清除本地凭据，可使用 monkey_logout 等工具。