Git取证MCP
用于深度git存储库调查和分析的专用模型上下文协议(MCP)服务器。这个取证工具提供了对存储库历史、分支关系和开发模式的详细见解,只关注git存储库分析,而不是一般的GitHub或git操作。
特性
服务器提供四种主要分析工具:
- 分行概况 (
get_branch_overview)
- 提供分支状态和关系的高级概述 - 分析上次提交、提交计数和合并库 - 生成分支机构活动的统计摘要
- 时间周期分析 (
analyze_time_period)
- 分析特定时间段内的详细开发活动 - 对提交进行分类(功能、修复、重构、文档、其他) - 提供带有提交模式的活动摘要
- 文件更改分析 (
analyze_file_changes)
- 跟踪跨分支对特定文件的更改 - 识别潜在冲突区域 - 为文件修改提供风险评估 - 根据风险水平生成推荐的审核订单
- 合并建议 (
get_merge_recommendations)
- 确定最佳合并策略 - 评估冲突风险 - 识别代码热点 - 提供分步合并指导
输入参数
每个工具都需要特定的参数:
repoPath:git存储库的路径branches:要分析的分支名称数组outputPath:写入分析结果的路径- 其他工具特定参数:
- timeRange:周期分析的开始和结束日期 - files:用于文件更改分析的文件路径数组
输出格式
所有工具输出包含以下内容的JSON文件:
- 详细分析结果
- 汇总统计
- 风险评估(如适用)
- 基于分析的建议
技术细节
- 使用TypeScript构建
- 使用MCP SDK实现服务器
- 通过子进程执行git命令
- 提供错误处理和验证
- 在stdio传输上运行
依赖项
- @模型上下文协议/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
