Git仓库分析服务

MCP Git分析服务器是一款分析本地Git仓库并提供提交、贡献者和文件变更洞察的工具。

  • by Jaz-spec
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Jaz-spec/alex_mcp_workshop

使用说明

MCP Git 分析服务器

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

特点/功能

工具

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

    • 按计数、作者或日期范围筛选
    • 返回详细的提交信息,包括更改内容
  2. 查找热点 - 查找更改最频繁的文件

    • 显示提交次数最多的文件
    • 包括每个文件中的独特作者数量
  3. 获取贡献者 - 列出所有贡献者及其统计数据

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

资源

  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