Fork Parity MCP

🚀 🔄 Fork Parity MCP v2.0.0

这是一款全面的MCP服务器，它彻底改变了您与上游仓库保持分支一致性的方式。具备智能提交分析、自动冲突检测、GitHub Actions集成和高级通知系统等功能，专为管理复杂分支关系的团队和组织打造。

🚀 快速开始

安装

npm install -g @moikas/fork-parity-mcp

基本设置

1. 配置您的Git远程仓库：

# 添加上游远程仓库（如果尚未添加）
git remote add upstream https://github.com/original/repository.git

# 验证远程仓库
git remote -v

2. 添加到您的MCP配置中：

{
  "mcpServers": {
    "fork-parity": {
      "command": "node",
      "args": ["/path/to/fork-parity-mcp/src/enhanced-server.js"],
      "env": {
        "REPO_PATH": "/path/to/your/fork"
      }
    }
  }
}

3. 可选：设置GitHub Actions自动化：

# 生成工作流文件
fork-parity setup-github-actions --workflows=daily_sync,pr_checks,critical_alerts

4. 开始跟踪：

# 获取最新的上游更改
git fetch upstream

# 您可以开始使用啦！🎉

✨ 主要特性

🧠 人工智能驱动的分析

• 🔍 智能提交分类 - 自动根据影响和优先级对提交进行分类
• 🎯 高级分析 - 深度依赖链分析、重大变更检测
• 🛡️ 安全评估 - 自动进行安全影响评估
• ⚡ 性能影响 - 预测上游更改对性能的影响

🚀 自动化与集成

• 🤖 GitHub Actions工作流 - 通过自动检查实现完整的CI/CD集成
• 📊 实时仪表盘 - 全面的一致性状态，并提供可操作的见解
• 🔔 多渠道通知 - 支持Slack、Discord、电子邮件和Webhook
• 📋 迁移规划 - 自动解决冲突并制定集成路线图

🎛️ 企业级特性

• 📈 分析与指标 - 跟踪集成速度和技术债务
• 🔄 批量处理 - 智能优先处理多个提交
• 🎨 可定制的工作流 - 适应您团队的特定流程
• 🌐 多仓库支持 - 从单个界面管理多个分支

🛠️ 开发者体验

• 💡 学习系统 - 随着时间的推移适应您的集成模式
• 🔧 冲突模拟 - 在集成前预览合并冲突
• 📝 审查模板 - 结构化的提交审查和文档记录
• 🎯 影响分析 - 了解更改的下游影响

💻 使用示例

基础用法

🧠 人工智能驱动的分析

"自动对最近20个上游提交进行分类"
"对提交abc123进行高级分析，包括安全评估"
"批量分析上一个冲刺阶段的提交"

📊 仪表盘与监控

"生成全面的一致性仪表盘"
"显示高优先级的可操作项"
"获取自上月以来的详细状态"

🔄 集成规划

"为下一季度创建集成计划"
"为提交abc123、def456、ghi789生成迁移计划"
"分析提交xyz890的潜在冲突"

🤖 自动化

"与上游同步并进行全面分析"
"设置GitHub Actions的每日同步和PR检查工作流"
"配置Slack的关键警报通知"

📝 审查与文档记录

"为提交abc123创建审查模板"
"将提交def456的状态更新为已集成，并添加适配说明"
"从这次成功的集成模式中学习"

🛠️ 可用工具（共15个）

🧠 分析与分类

📊 状态与监控

🔄 集成与规划

🤖 自动化与工作流

🔔 通知与学习

⚙️ 配置

环境变量

高级配置

{
  "mcpServers": {
    "fork-parity": {
      "command": "fork-parity-mcp",
      "env": {
        "UPSTREAM_REMOTE_NAME": "origin-upstream",
        "UPSTREAM_BRANCH": "develop",
        "REPO_PATH": "/home/user/my-fork"
      }
    }
  }
}

多项目配置

同时跟踪多个分支：

{
  "mcpServers": {
    "project-a-parity": {
      "command": "fork-parity-mcp",
      "env": {
        "REPO_PATH": "/home/user/project-a"
      }
    },
    "project-b-parity": {
      "command": "fork-parity-mcp", 
      "env": {
        "REPO_PATH": "/home/user/project-b",
        "UPSTREAM_BRANCH": "development"
      }
    }
  }
}

📁 状态跟踪

服务器会创建一个.parity-status.json文件来跟踪：

{
  "commits": {
    "abc123": {
      "status": "integrated",
      "notes": "应用时对我们的认证系统进行了修改",
      "timestamp": "2024-01-15T10:30:00Z"
    },
    "def456": {
      "status": "skipped", 
      "notes": "不适用于我们的分支",
      "timestamp": "2024-01-15T11:00:00Z"
    }
  },
  "lastUpdated": "2024-01-15T11:00:00Z"
}

状态类型

• ✅ 已集成 - 成功合并/应用
• 🔍 已审查 - 已分析但尚未集成
• ⏭️ 已跳过 - 不适用于您的分支
• ⚠️ 有冲突 - 需要手动解决
• ⏸️ 已推迟 - 推迟到未来集成
• 🔄 待处理 - 等待分析或审查

🔧 技术细节

开发环境要求

• Node.js 18+
• 带有上游远程仓库的Git仓库

本地开发

# 克隆仓库
git clone https://github.com/moikas-code/fork-parity-mcp.git
cd parity-mcp

# 安装依赖
npm install

# 运行增强服务器
node src/enhanced-server.js

# 或者运行CLI
node src/cli.js --help

测试

# 检查语法
npm run check-syntax

# 代码检查（已配置ESLint）
npx eslint src/*.js --ignore-pattern="*-old.js"

# 测试服务器启动
node src/enhanced-server.js

# 检查包
npm pack --dry-run

🤝 贡献代码

欢迎贡献代码！请随时提交拉取请求。

1. 分叉仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加惊人的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开拉取请求

📄 许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。

🆕 v2.0.0的新特性

• 🧠 人工智能驱动的提交分类 - 智能分类和优先级排序
• 🔍 高级分析引擎 - 深度依赖链、安全评估、性能影响
• 🤖 GitHub Actions集成 - 完整的工作流自动化，带有可定制的模板
• 📊 实时仪表盘 - 全面的分析和可操作的见解
• 🔔 多渠道通知 - 支持Slack、Discord、电子邮件和Webhook
• 🎯 冲突模拟 - 在集成前预览和解决冲突
• 📈 学习系统 - 随着时间的推移适应您的集成模式
• 🚀 企业级特性 - 批量处理、迁移规划和团队工作流

🙏 致谢

• 基于模型上下文协议（MCP）构建
• 受开源项目中保持分支一致性需求的启发
• 感谢MCP社区提供的优秀SDK
• 特别感谢帮助项目达到v2.0.0生产就绪状态的贡献者

📚 相关链接

• MCP SDK文档
• Claude桌面版MCP指南
• Git远程管理
• GitHub Actions文档
• 完整实现指南