Git 取证 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 获取许可证副本。