用途
git-context-mcp 是一个 MCP（Model Context Protocol）服务器，目标是回答开发者常见的问题：“这段代码为什么存在？”
传统的 git blame 只能告诉你某一行是谁写的，而 git-context-mcp 进一步追溯该行背后的提交、落地该提交的 Pull Request、PR 描述以及所有关联的 GitHub Issue，帮助理解代码的历史背景与决策原因。
主要能力
- 给定文件与行范围，运行 git blame -p 找到对应的提交哈希。
- 对每个提交调用 git show，获取完整提交信息与 diff 统计。
- 通过 GitHub API（gh api /repos/:owner/:repo/commits/:hash/pulls）查找关联的 Pull Request。
- 解析 PR 正文中的 #NNN 和 /issues/NNN 引用，并获取每个 Issue 的内容。
- 将所有结果以结构化 Markdown 返回，供 Claude 进行推理与展示。
使用方式
安装方式有三种：
- 使用 npx（无需安装）。
- 全局安装。
- 手动配置：将配置添加到 ~/.claude/claude_mcp_config.json，然后重启 Claude Code。
使用环境为 Claude Code 或任何兼容 MCP 的客户端。
GitHub PR/Issue 查询需要 gh CLI（需安装）并执行 gh auth login。未安装 gh 时工具仍可运行，只是会跳过 PR/Issue 上下文。
安装完成后，可在任意 git 仓库中直接用自然语言与 Claude 对话来使用。
适用场景
- 需要理解某段代码的历史原因与设计决策时。
- 排查代码变更背景，快速定位相关 PR 与 Issue。
- 在 Claude 中直接获取代码上下文，避免手动翻阅 git log、搜索 GitHub 和交叉比对 Issue 跟踪器。
限制
- 不存储令牌。
- 除 GitHub 自身 API 外，不向其他地方发送数据（与 gh CLI 行为一致）。
- 未安装 gh CLI 时无法获取 PR 与 Issue 上下文。
- 整个服务器代码位于 src/index.ts。
其他
欢迎提交 PR。
