Git Forensics MCP

Git Forensics MCP

一个专用于深入调查和分析 Git 仓库的模型上下文协议（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 License, Version 2.0 授权，详情请参阅 LICENSE.txt 文件。

欢迎协作

欢迎 Fork 和贡献。

所有贡献均采用 Apache License 2.0 授权。这一宽松许可证允许你：

• 将代码用于商业用途
• 修改和分发代码
• 创作衍生作品
• 将代码纳入其他项目

版权所有 2025。根据 Apache License, Version 2.0 授权；除非遵守该许可证，否则不得使用本项目。你可以通过 http://www.apache.org/licenses/LICENSE-2.0 获取许可证副本。