工具

28个基特业务,分为7个类别:

资源

提示

开始

运行时间

和Bun和Node.js一起工作 运行时间是自动检测的.

MCP 客户端配置

添加以下内容到您的 MCP 客户端配置( 例如 ), cline_mcp_settings.json) (中文(简体) ). 更新环境变量以匹配您的设置—— 尤其是 git 身份字段 .

{
  "mcpServers": {
    "git-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["@cyanheads/git-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "GIT_BASE_DIR": "~/Developer/",
        "LOGS_DIR": "~/Developer/logs/git-mcp-server/",
        "GIT_USERNAME": "cyanheads",
        "GIT_EMAIL": "[email protected]",
        "GIT_SIGN_COMMITS": "true"
      }
    }
  }
}

Bun 用户: 替换 "command": "npx" 与 "command": "bunx"。 。 。 .

用于可流式 HTTP, 设置 MCP_TRANSPORT_TYPE=http 财务报告和审定财务报表 MCP_HTTP_PORT=3015。 。 。 .

特征

建造在 mcp-ts-template。 。 。 .

警卫

• 所有文件路径都经过验证和消毒,以防止目录的转录.
• 可选 GIT_BASE_DIR 将操作限制在用于多租户沙箱的特定目录树上.
• Git指令通过过程产卵使用经过验证的参数——无外壳插值.
• JWT和OAuth支持经认证的部署.
• 通过DI管理限制可选费率 RateLimiter 服务.
• 所有业务都记录在审计请求上.

配置

所有配置在启动时验证 src/config/index.ts关键环境变量:

运行服务器

Via 软件包管理器( 无安装)

npx @cyanheads/git-mcp-server@latest

通过环境变量或您的 MCP 客户端配置配置 .

地方发展

# Build and run
npm run rebuild
npm run start:stdio   # or start:http

# Dev mode with hot reload
npm run dev:stdio     # or dev:http

# Checks and tests
npm run devcheck      # lint, format, typecheck
npm test

云花岗工人

npm run build:worker   # Build the worker bundle
npm run deploy:dev     # Run locally with Wrangler
npm run deploy:prod    # Deploy to Cloudflare

项目结构

答复格式

通过配置输出格式和动词 MCP_RESPONSE_FORMAT 财务报告和审定财务报表 MCP_RESPONSE_VERBOSITY。 。 。 .

JSON 格式( 默认, LLM 消费优化) :

{
  "success": true,
  "branch": "main",
  "staged": ["src/index.ts", "README.md"],
  "unstaged": ["package.json"],
  "untracked": []
}

标记下的格式( 人可读) :

# Git Status: main

## Staged (2)
- src/index.ts
- README.md

## Unstaged (1)
- package.json

LLM 总是通过 responseFormatter ——完整文件列表,元数据,时间戳——无论客户端显示什么. Verbosity控制包含多少细节: minimal (只有核心领域), standard (平衡),或 full (诸事.

发展指南

见 AGENTS.md 用于建筑、工具开发模式和贡献规则.

测试

测试使用情况 Bun的测试跑道 与 Vitest 兼容.

bun test              # Run all tests
bun test --coverage   # With coverage
bun run devcheck      # Lint, format, typecheck, audit

路线图

服务器使用基于提供者的架构进行 git 操作 :

• CLI 供应商 (目前)——通过土生土长的git CLI实现全28个工具覆盖. 需要安装本地基特.
• 异态提供商 (计划)——实施边境部署的纯JS(Cloudflare Workers,Vercel Edge,Deno部署). 用途 同位素 - git。 。 。 .
• GitHub API 供应商 (可能)——通过GitHub REST/GraphQL API进行云-内生操作,不需要本地回放.

捐款

欢迎提出问题和拉动请求。 提交前运行检查 :

npm run devcheck
npm test

许可证

阿帕奇2.0 (英语). 见 自由主义。 。 。 .