Gi

git-insight-mcp

通过 MCP 进行语义化 Git 查询。超越 git log——回答关于任意行、文件或分支的谁、什么、何时、为何。

可与 terminal-history-mcp 和 localhost-mcp 搭配使用。三者结合：你运行过什么、正在运行什么、你修改了什么。

为什么

开发者总会问这些问题，但 git 不擅长回答：

• “最后是谁改动了这个函数？”——git blame 只显示行，不会按区域显示作者
• “哪个 PR 引入了这一行？”——需要手动执行：blame → commit SHA → 搜索 GH
• “哪些文件总是一起更改？”——没有内置功能
• “显示超过 30 天且尚未合并的分支”——需要各种 Bash 单行命令
• “我上周做了什么？”——需要手动翻查日志

LLM Agent 需要这些上下文才能安全地修改代码。目前它们只运行 git log -n 5，会遗漏所有信息。

安装

npm install -g git-insight-mcp

接入 Claude Code：

claude mcp add --scope user git-insight -- git-insight-mcp

也可用于任何兼容 MCP 的客户端。以 stdio MCP 服务的形式运行。

若要查询 PR / issue，请设置 GitHub 令牌：

export GH_TOKEN=ghp_...

没有令牌时，本地 Git 工具仍可使用。PR 关联功能将跳过。

工具

工具	用途
who_touched	按作者归类 blame 结果。显示行、提交、最近修改时间和主要负责人。可选按行范围缩小查询。
introducing_pr	查找引入某行（或某次提交）的 PR。优先解析合并消息；否则使用 GitHub API。
co_change	查找最常与输入文件一起更改的文件。
branch_hygiene	列出分支的领先/落后状态、最近提交、合并状态和过期标记。
recent_work	站会助手：在指定时间范围内查看作者的提交、文件及增删行数。
commit_context	完整的提交上下文：主题、正文、文件、PR 和相关 issue。

输出示例（who_touched）

{
  "file": "src/auth.ts",
  "total_lines": 124,
  "authors": [
    { "name": "alice", "email": "[email protected]", "lines": 87, "commits": 12, "last_commit_date": "2026-04-12T10:33:01.000Z" },
    { "name": "bob", "email": "[email protected]", "lines": 37, "commits": 4, "last_commit_date": "2026-01-03T18:14:55.000Z" }
  ],
  "primary_owner": "alice"
}

CLI 用法（健全性检查）

git-insight-mcp who-touched src/auth.ts
git-insight-mcp co-change src/auth.ts
git-insight-mcp branches
git-insight-mcp recent alice
git-insight-mcp commit a3e577e
git-insight-mcp intro-pr src/auth.ts:42
git-insight-mcp intro-pr a3e577e
git-insight-mcp                # MCP stdio server

从源代码构建

git clone https://github.com/HasanJahidul/git-insight-mcp.git
cd git-insight-mcp
npm install
npm run build
node dist/cli.js branches

限制（v0.1）

• 仅支持 GitHub（暂不支持 GitLab / Bitbucket）。
• co_change 的复杂度为 O(window × files-per-commit)——默认最多检查 1000 次提交。
• 函数级 blame 按行范围进行，而非基于 AST。暂不跟踪重命名。
• 受 GH API 速率限制（通过身份验证时为 5000/h）。此版本不会缓存 PR 结果。

许可证

MIT