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。
  • 安装步骤
      1. 克隆或下载代码到本地环境
      1. 安装依赖并构建(通常使用 npm 或 pnpm 安装并编译 TypeScript 代码)
      1. 调整本地密钥与安装信息,完成初始化(如 git-steer init)
      1. 启动 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 响应。

服务器信息