MCP Git Analysis Server

MCP Git 分析服务器

一个MCP（模型上下文协议）服务器，用于分析本地Git仓库，并提供有关提交、贡献者和文件更改的见解。

特点/功能

工具

1. 分析提交（或提交记录） - 获取提交统计信息，并可选择应用过滤器

- 按计数、作者或日期范围筛选 - 返回详细的提交信息，包括更改内容

1. 查找热点 - 查找更改最频繁的文件

- 显示提交次数最多的文件 - 包括每个文件中的独特作者数量

1. 获取贡献者 - 列出所有贡献者及其统计数据

- 显示提交次数、插入行数、删除行数 - 包括首次提交和最后一次提交的日期

资源

1. git://recent-activity 翻译为中文是：“git://最近活动” 或者 “git://最新动态” - 最近10次提交的结构化数据
2. git://file-history/{文件路径} - 指定文件的更改历史

安装

# Install dependencies
pip install -r requirements.txt

使用方法

使用MCP Inspector

# Run the server with MCP Inspector
mcp dev server.py

作为MCP服务器

在您的MCP客户端设置中进行配置：

{
  "mcpServers": {
    "git-analysis": {
      "command": "python3",
      "args": ["/path/to/server.py"]
    }
  }
}

示例工具调用

分析最近的提交

{
  "name": "analyze_commits",
  "arguments": {
    "count": 5
  }
}

寻找热点

{
  "name": "find_hot_spots",
  "arguments": {
    "limit": 10
  }
}

获取贡献者

{
  "name": "get_contributors",
  "arguments": {}
}

示例资源访问

• git://recent-activity - 获取最近活动
• git://file-history/src/main.py - 获取特定文件的历史记录

要求

• Python 3.8及以上版本
• Git 仓库
• GitPython 库
• MCP SDK（MCP软件开发工具包）

测试

使用MCP Inspector进行测试：

npx @modelcontextprotocol/inspector python3 server.py