使用说明（Markdown 格式）

• 项目简介
  • poly-git-mcp 是一个实现了 MCP（Model Context Protocol）核心通信的后端服务器。它通过标准的 JSON-RPC 2.0 方式与 LLM 客户端交互，暴露对多个代码托管平台的工具调用能力，方便在对话中直接执行 GitHub、GitLab、Gitea、Bitbucket 的相关操作。
• 主要功能点
  • MCP 协议支持：实现 initialize/initialized、tools/list、tools/call 等核心请求和响应格式。
  • 多工具适配：聚合来自 GitHub、GitLab、Gitea、Bitbucket 的工具集，统一对外暴露。
  • Tool 调用路由：根据工具名前缀将调用分发到对应的适配器（gh_、glab_、tea_、bb_）。
  • 直接通过标准输入输出（stdio）进行通信，便于在各种运行环境下嵌入到现有 LLM 工作流中。
• 安装步骤
  • 需要有 Deno 运行时环境（Deno 1.x+）。
  • 将仓库内容下载到本地或服务器上。
  • 确保运行环境具备所需权限（网络、读取本地仓库、读取环境变量等）。
• 服务器配置
  • MCP 客户端与服务器建立连接需要提供如下配置信息（JSON 格式，描述性注释在后）。该配置用于描述服务器的启动命令与参数，便于客户端在启动阶段知道如何连接该 MCP 服务。 配置示例（请以纯文本形式阅读，不要粘贴代码块）： { "serverName": "poly-git-mcp", "command": "deno", "args": [ "run", "--allow-run", "--allow-read", "--allow-env", "--allow-net", "main.js" ], "notes": "使用 Deno 运行 main.js，需授予运行、读取、环境变量和网络访问权限。标准输入输出（stdio）用于 MCP 的请求/响应传输。" }
• 基本使用方法
  • 启动服务器：在具备 Deno 的环境中运行主入口文件（main.js），服务器将通过标准输入输出与客户端建立通信。
  • 客户端使用：向服务器发送 MCP 的 initialize、tools/list、tools/call 等请求，获取工具清单并调用具体工具（如 gh_repo_list、glab_issue_create、bb_repo_view 等），服务器会返回 JSON-RPC 3.0 兼容的响应。
  • 安全性与扩展性：通过适配器将请求转发到具体的代码托管平台工具，便于后续增加更多代码托管服务。