mcpField
G
git-summary

git-summary

本地服务
github.com/yifanyifan897645版本控制028 周前更新

关于 git-summary

git-summary 是面向 AI 编码助手的本地 Git 仓库分析 MCP 服务,可从仓库历史生成结构化概览、变更说明和健康检查。它涵盖提交、代码归属与分支状态,帮助理解代码库演进。

主要功能

  1. 01仓库概览与提交统计
  2. 02提交范围语义变更摘要
  3. 03文件行级归属分析
  4. 04按提交类型生成变更日志
  5. 05检查分支新旧及领先落后状态
  6. 06搜索提交消息与代码变更

适用场景

  1. 01梳理仓库贡献者和近期提交
  2. 02比较版本或分支间的改动
  3. 03定位文件行的修改者与提交
  4. 04生成发布说明并查找引入变更

MCP 相关

该 MCP 服务向 Claude、Cursor 等 MCP 客户端提供 Git 仓库概览、变更、blame、分支健康和历史搜索工具。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"yifanyifan897645-git-summary": {
"command": "npx",
"args": [
"-y",
"git-summary-mcp"
]
}
}
}
启动命令npx -y git-summary-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmgit-summary-mcp0.1.2

工具

6

收录的工具列表 · 更新于 2 周前

参数类型必填说明
repo_pathstring否Git 仓库的路径(默认为当前工作目录)
commit_countnumber否要包含的近期提交数量(默认 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 工具包的一部分

查看所有服务 →

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。