Git Forensics MCP

一个专门用于深入调查和分析Git仓库的Model Context Protocol (MCP)服务器。此取证工具提供了对仓库历史、分支关系和开发模式的详细洞察，专注于Git仓库分析，而不是一般的GitHub或Git操作。

功能

该服务器提供四个主要分析工具：

1. 分支概览 (get_branch_overview)

   • 提供分支状态和关系的高层次概述
   • 分析最近的提交、提交次数和合并基础
   • 生成分支活动的统计总结

2. 时间段分析 (analyze_time_period)

   • 分析特定时间段内的详细开发活动
   • 对提交进行分类（特性、修复、重构、文档、其他）
   • 提供带有提交模式的活动总结

3. 文件变更分析 (analyze_file_changes)

   • 跟踪特定文件在各个分支中的变更
   • 识别潜在冲突区域
   • 提供文件修改的风险评估
   • 根据风险等级生成推荐审查顺序

4. 合并建议 (get_merge_recommendations)

   • 确定最佳合并策略
   • 评估冲突风险
   • 识别代码热点
   • 提供逐步合并指导

输入参数

每个工具需要特定的参数：

• repoPath: Git仓库的路径
• branches: 需要分析的分支名称数组
• outputPath: 分析结果将写入的路径
• 其他工具特定参数：
  • timeRange: 时间段分析的开始和结束日期
  • files: 文件变更分析的文件路径数组

输出格式

所有工具输出包含以下内容的JSON文件：

• 详细的分析结果
• 汇总统计数据
• 风险评估（适用时）
• 基于分析的建议

技术细节

• 使用TypeScript构建
• 使用MCP SDK实现服务器
• 通过子进程执行Git命令
• 提供错误处理和验证
• 在stdio传输上运行

依赖项

• @modelcontextprotocol/sdk
• Node.js
• Git（必须安装并可访问）

使用方法

该服务器作为MCP服务运行，并可以与任何兼容MCP的客户端集成。所有分析结果将以JSON格式写入指定的输出文件中。

贡献和许可

本项目根据Apache许可证2.0版发布 - 详情见LICENSE.txt文件。

欢迎合作

欢迎分叉和贡献。

所有贡献都将遵循Apache许可证2.0。此宽松许可证允许您：

• 商业使用代码
• 修改和分发代码
• 创建衍生作品
• 包含在其他项目中

版权所有2025。根据Apache许可证2.0版使用该项目；除非符合许可证，否则不得使用该项目。您可以在http://www.apache.org/licenses/LICENSE-2.0获取许可证副本。