Enterprise-grade fork parity management with AI-powered analysis and automated workflows

A comprehensive MCP server that revolutionizes how you maintain fork parity with upstream repositories. Features intelligent commit analysis, automated conflict detection, GitHub Actions integration, and advanced notification systems. Built for teams and organizations managing complex fork relationships.

• 🔍 Smart Commit Triage - Automatically categorize commits by impact and priority
• 🎯 Advanced Analysis - Deep dependency chain analysis, breaking change detection
• 🛡️ Security Assessment - Automated security impact evaluation
• ⚡ Performance Impact - Predict performance implications of upstream changes

• 🤖 GitHub Actions Workflows - Complete CI/CD integration with automated checks
• 📊 Real-time Dashboards - Comprehensive parity status with actionable insights
• 🔔 Multi-channel Notifications - Slack, Discord, email, and webhook support
• 📋 Migration Planning - Automated conflict resolution and integration roadmaps

• 📈 Analytics & Metrics - Track integration velocity and technical debt
• 🔄 Batch Processing - Handle multiple commits with intelligent prioritization
• 🎨 Customizable Workflows - Adapt to your team's specific processes
• 🌐 Multi-repository Support - Manage multiple forks from a single interface

• 💡 Learning System - Adapts to your integration patterns over time
• 🔧 Conflict Simulation - Preview merge conflicts before integration
• 📝 Review Templates - Structured commit review and documentation
• 🎯 Impact Analysis - Understand downstream effects of changes

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

1. Configure your Git remotes:

# Add upstream remote (if not already added)
git remote add upstream https://github.com/original/repository.git

# Verify remotes
git remote -v

2. Add to your MCP configuration:

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

3. Optional: Set up GitHub Actions automation:

# Generate workflow files
fork-parity setup-github-actions --workflows=daily_sync,pr_checks,critical_alerts

4. Start tracking:

# Fetch latest upstream changes
git fetch upstream

# You're ready to go! 🎉

"Auto-triage the last 20 upstream commits"
"Run advanced analysis on commit abc123 including security assessment"
"Batch analyze commits from the last sprint"

"Generate a comprehensive parity dashboard"
"Show me actionable items with high priority"
"Get detailed status since last month"

"Create an integration plan for the next quarter"
"Generate migration plan for commits abc123, def456, ghi789"
"Analyze potential conflicts for commit xyz890"

"Sync with upstream and run full analysis"
"Set up GitHub Actions with daily sync and PR checks"
"Configure Slack notifications for critical alerts"

"Create a review template for commit abc123"
"Update commit def456 status to integrated with adaptation notes"
"Learn from this successful integration pattern"

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

Track multiple forks simultaneously:

{
  "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"
      }
    }
  }
}

The server creates a .parity-status.json file to track:

{
  "commits": {
    "abc123": {
      "status": "integrated",
      "notes": "Applied with modifications for our auth system",
      "timestamp": "2024-01-15T10:30:00Z"
    },
    "def456": {
      "status": "skipped", 
      "notes": "Not applicable to our fork",
      "timestamp": "2024-01-15T11:00:00Z"
    }
  },
  "lastUpdated": "2024-01-15T11:00:00Z"
}

• ✅ integrated - Successfully merged/applied
• 🔍 reviewed - Analyzed but not yet integrated
• ⏭️ skipped - Not applicable to your fork
• ⚠️ conflict - Requires manual resolution
• ⏸️ deferred - Postponed for future integration
• 🔄 pending - Awaiting analysis or review

• Node.js 18+
• Git repository with upstream remote

# Clone the repository
git clone https://github.com/moikas-code/fork-parity-mcp.git
cd parity-mcp

# Install dependencies
npm install

# Run the enhanced server
node src/enhanced-server.js

# Or run the CLI
node src/cli.js --help

# Check syntax
npm run check-syntax

# Lint code (ESLint configured)
npx eslint src/*.js --ignore-pattern="*-old.js"

# Test server startup
node src/enhanced-server.js

# Check package
npm pack --dry-run

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• 🧠 AI-Powered Commit Triage - Intelligent categorization and prioritization
• 🔍 Advanced Analysis Engine - Deep dependency chains, security assessment, performance impact
• 🤖 GitHub Actions Integration - Complete workflow automation with customizable templates
• 📊 Real-time Dashboards - Comprehensive analytics and actionable insights
• 🔔 Multi-channel Notifications - Slack, Discord, email, and webhook support
• 🎯 Conflict Simulation - Preview and resolve conflicts before integration
• 📈 Learning System - Adapts to your integration patterns over time
• 🚀 Enterprise Features - Batch processing, migration planning, and team workflows

• Built with Model Context Protocol (MCP)
• Inspired by the need to maintain fork parity in open source projects
• Thanks to the MCP community for the excellent SDK
• Special thanks to contributors who helped reach v2.0.0 production readiness

• MCP SDK Documentation
• Claude Desktop MCP Guide
• Git Remote Management
• GitHub Actions Documentation
• Complete Implementation Guide