git-steer MCP 服务器
- 项目简介
- 这是一个基于 MCP(Model Context Protocol)的后端服务器实现,旨在以标准化方式向大型语言模型客户端提供资源管理、工具调用及提示模板渲染等能力,并通过 JSON-RPC 与客户端通信。
- 主要功能点
- 资源与状态管理:通过 GitHub 状态仓库持久化配置、日志、RFC、质量分析等数据,并提供读取与写入接口。
- 工具注册与执行:实现了大量工具(如 repo_list、security_fix_pr、workflow_status、config_show 等)的注册与执行逻辑,允许 LLM 调用外部功能。
- 提示与管控:包含面向操作的各类工具说明及参数验证,支持多种自动化工作流触发。
- 传输协议:当前实现支持 stdio 传输(可直接与 Claude、Llama、等本地 LLM 工作流对接),未来可扩展至 HTTP/SSE 等传输。
- 审计与会话管理:对所有操作进行审计记录,且在关机时将变更持久化回 GitHub。
- 安装步骤
-
- 克隆或下载代码到本地环境
-
- 安装依赖并构建(通常使用 npm 或 pnpm 安装并编译 TypeScript 代码)
-
- 调整本地密钥与安装信息,完成初始化(如 git-steer init)
-
- 启动 MCP 服务器(默认使用 stdio 传输)
-
- 服务器配置(供 MCP 客户端设置连接使用,客户端不需要修改服务端代码)
- 服务器名称:git-steer
- 启动命令:npx
- 启动参数:git-steer
- 备注:客户端需要在配置中指向该服务器名称,并提供启动命令及参数以建立连接,例如 Claude Desktop 或其他 MCP 客户端的配置中包含 serverName、command 与 args 字段,用于启动服务器进程并通过 stdio 与其通信。以下为示例描述(请以实际运行环境为准):
- 示例 JSON(文字描述,不作为代码块展示):
- serverName: "git-steer"
- command: "npx"
- args: ["git-steer"]
- 说明:该配置表示通过 npx 启动 git-steer 服务,该客户端后续将通过 MCP 协议与服务器建立 JSON-RPC 通信。
- 基本使用方法
- 第一次使用前执行初始化:运行初始化流程以在 GitHub 上创建 App、安装、并创建私有状态仓库,以及将凭证写入本地钥匙串(macOS Keychain)。
- 启动 MCP 服务器:在终端执行启动命令,服务器将以 stdio 传输模式提供 MCP 服务,等待客户端接入。
- 客户端连接与调用:MCP 客户端(如 Claude Desktop、自定义前端或其他 LLM 客户端)通过 JSON-RPC 请求与服务器交互,查询资源、调用工具、获取 Prompts,并接收服务器返回的 JSON-RPC 响应。