Git仓库分析MCP
一个专门用于深入分析Git仓库的MCP服务器，提供分支概览、时间段分析、文件变更和合并建议等工具。
可用工具 （4 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
get_branch_overview 3 个参数 需填 3 项
Get high-level overview of branch states and relationships
必填参数：repoPath、branches、outputPath
analyze_time_period 4 个参数 需填 4 项
Analyze detailed development activity in a specific time period
必填参数：repoPath、branches、timeRange、outputPath
analyze_file_changes 4 个参数 需填 4 项
Analyze changes to specific files across branches
必填参数：repoPath、branches、files、outputPath
get_merge_recommendations 3 个参数 需填 3 项
Get detailed merge strategy recommendations
必填参数：repoPath、branches、outputPath
服务介绍
Git Forensics 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 传输
依赖项
- @modelcontextprotocol/sdk
- Node.js
- Git（必须安装并可访问）
使用方法
该服务器作为 MCP 服务运行，并可以与任何兼容 MCP 的客户端集成。所有分析结果将以 JSON 格式写入指定的输出文件中。
贡献和许可
该项目根据 Apache License, Version 2.0 许可证发布 - 详情请参阅 LICENSE.txt 文件。
欢迎合作
欢迎分叉和贡献。
所有贡献都将遵循 Apache License 2.0。此宽松许可证允许您：
- 商业使用代码
- 修改和分发代码
- 创建衍生作品
- 包含在其他项目中
版权所有 2025。根据 Apache 许可证 2.0 版（以下简称“许可证”）获得许可；除非遵守许可证，否则不得使用本项目。您可以在 http://www.apache.org/licenses/LICENSE-2.0 获取许可证的副本。
