Fork Parity

Fork Parity MCP v2.0.0 is an enterprise-grade MCP server designed to help you maintain parity between forks and upstream repositories. It combines AI-powered analysis, automated workflows, and real-time dashboards to streamline integration planning, conflict detection, and multi-repository management. This guide walks you through practical usage, installation steps, and essential configuration so you can start tracking and coordinating fork changes effectively.

How to use

You operate Fork Parity MCP from a client that speaks MCP requests to the local or remote MCP server. Start by configuring your fork as an MCP server in your environment, then use the available commands to analyze upstream changes, generate integration plans, and push updates back into your fork. You can track status, conflicts, and actions from a centralized parity view, and you can set up multi-channel notifications to stay informed.

How to install

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

# Basic setup: add your upstream and verify remotes
git remote add upstream https://github.com/original/repository.git
git remote -v

# Add to your MCP configuration (stdio mode) with the enhanced server entry

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

# Optional: set up automation and start tracking
fork-parity setup-github-actions --workflows=daily_sync,pr_checks,critical_alerts

# Start tracking (fetch latest upstream changes)
git fetch upstream

Configuration

Configure environment variables and per-server settings to tailor Fork Parity MCP to your workflow.

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

# Environment variables you may reference

UPSTREAM_REMOTE_NAME: upstream (name of upstream remote)
UPSTREAM_BRANCH: main (upstream branch to track)
REPO_PATH: /path/to/your/fork (path to your Git repository)

# Example for multiple projects

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

Status tracking and status file

The server maintains a status file that records per-commit results, notes, and timestamps so you can review what happened during parity processing.

.parity-status.json
{
  "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"
}

# Status types you will see

• integrated
• reviewed
• skipped
• conflict
• deferred
• pending

## Troubleshooting and notes

If you encounter conflicts during integration, use the Conflict Simulation feature to preview resolutions before applying changes. Ensure your upstream remote is correctly configured and accessible. For automation issues, verify that GitHub Actions workflows are generated and that the required secrets and environment variables are set in your CI environment.

## Available tools

### fork\_parity\_auto\_triage\_commits

AI-powered commit categorization and prioritization to identify impact and urgency of upstream changes.

### fork\_parity\_advanced\_analysis

Deep analysis of dependencies, security impact, and performance implications of upstream changes.

### fork\_parity\_batch\_analyze\_commits

Process multiple commits in a batch with intelligent triage and prioritization.

### fork\_parity\_get\_detailed\_status

Provide a comprehensive parity status with analytics and context.

### fork\_parity\_generate\_dashboard

Generate a real-time dashboard with parity metrics and insights.

### fork\_parity\_get\_actionable\_items

Produce a prioritized list of commits requiring action.

### fork\_parity\_update\_commit\_status

Update the status of a commit with rich metadata.

### fork\_parity\_create\_review\_template

Create structured review templates for commit reviews.

### fork\_parity\_generate\_integration\_plan

Create an integration roadmap with effort estimates.

### fork\_parity\_migration\_plan

Detailed migration planning for complex fork changes.

### fork\_parity\_sync\_and\_analyze

Automated upstream sync combined with analysis.

### fork\_parity\_setup\_github\_actions

Configure GitHub Actions workflows for parity automation.

### fork\_parity\_conflict\_analysis

Advanced conflict detection and suggested resolutions.

### fork\_parity\_setup\_notifications

Configure multi-channel notifications for parity events.

### fork\_parity\_learn\_adaptation

Machine learning from successful integrations to improve adaptation.