关于 git-summary
git-summary 是面向 AI 编码助手的本地 Git 仓库分析 MCP 服务,可从仓库历史生成结构化概览、变更说明和健康检查。它涵盖提交、代码归属与分支状态,帮助理解代码库演进。
主要功能
- 01仓库概览与提交统计
- 02提交范围语义变更摘要
- 03文件行级归属分析
- 04按提交类型生成变更日志
- 05检查分支新旧及领先落后状态
- 06搜索提交消息与代码变更
适用场景
- 01梳理仓库贡献者和近期提交
- 02比较版本或分支间的改动
- 03定位文件行的修改者与提交
- 04生成发布说明并查找引入变更
MCP 相关
该 MCP 服务向 Claude、Cursor 等 MCP 客户端提供 Git 仓库概览、变更、blame、分支健康和历史搜索工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
6收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| repo_path | string | 否 | Git 仓库的路径(默认为当前工作目录) |
| commit_count | number | 否 | 要包含的近期提交数量(默认 20) |
详细介绍
git-summary-mcp
一款 MCP 服务,让 AI 助手深入了解你的本地 Git 仓库。你可以在 Claude、Cursor 或任何 MCP 客户端中即时获取仓库概览、语义化变更摘要、blame 分析、自动生成的变更日志、分支健康状况检查和历史记录搜索。
快速开始
npx git-summary-mcp
零配置。无需 API 密钥,无需账号。在任何 Git 仓库中直接运行即可。
工具
git_summary
结构化的仓库概览:当前分支、近期提交、贡献者和统计数据。
"Summarize this repository"
"Who are the top contributors?"
"Show me the last 10 commits"
git_changes
总结任意提交范围内的语义化变更。查看哪些文件发生了变化、由谁修改,以及整体差异统计。
"What changed between v1.0 and v2.0?"
"Summarize the changes in the last week"
"What did the feature branch change?"
git_blame
分析文件归属:谁编写了每一行、何时编写,以及对应的提交。查看贡献者明细。
"Who last modified src/index.ts?"
"Show me the blame for lines 50-100 of app.py"
"Who owns most of this file?"
git_changelog
使用 Conventional Commits 检测,按提交类型(功能、修复、文档等)分组,自动生成变更日志。
"Generate a changelog for the last release"
"Create release notes from v1.0 to v2.0"
git_branch_health
查找过时分支、已合并且可清理的分支,以及超前或落后的分支。
"Which branches are stale?"
"Any branches that have been merged and can be deleted?"
"Show me branch health"
git_search
搜索提交消息和代码变更(pickaxe 搜索),查找某项内容是在何时引入或修改的。
"When was the login function added?"
"Find commits that mention 'authentication'"
"When was this config value changed?"
安装
Claude Desktop / Claude Code
添加到你的 MCP 配置中:
{
"mcpServers": {
"git-summary": {
"command": "npx",
"args": ["-y", "git-summary-mcp"]
}
}
}
Cursor
添加到 .cursor/mcp.json:
{
"mcpServers": {
"git-summary": {
"command": "npx",
"args": ["-y", "git-summary-mcp"]
}
}
}
Windsurf
按照上述相同格式添加到你的 MCP 配置中。
为什么?
AI 编码助手可以读取文件和运行命令,但它们并不会自动理解项目历史。这个 MCP 服务为它们提供结构化、节省令牌的 Git 情报,让它们能够:
- 了解谁在何时处理了哪些内容
- 生成准确的变更日志和发行说明
- 查找 Bug 是何时引入的
- 识别过时分支和可清理的内容
- 为代码评审和 PR 总结变更
要求
- Node.js 18+
- 已安装 Git,且可通过 PATH 访问
- 必须在 Git 仓库中运行(或指定一个 Git 仓库)
MCP 工具包的一部分
- webcheck-mcp — 网站健康状况分析
- git-summary-mcp — Git 仓库情报
- mcp-checkup — MCP 配置健康状况分析器
- dev-utils-mcp — 开发者工具
- codescan-mcp — 代码库健康状况扫描器
- deadlink-checker-mcp — 死链检测器
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。