codiff-mcp

TBosak/codiff-mcp

3.1

If you are the rightful owner of codiff-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Codiff MCP Server is a Model Context Protocol server designed for intelligent text diffing with a focus on token optimization.

Codiff MCP Server

A Model Context Protocol (MCP) server for intelligent text diffing with token optimization.

Features

  • Smart Change Detection: Shows only insertions/deletions by default to minimize tokens
  • Identical Text Optimization: Returns "identical" immediately for identical texts
  • Token-Saving Mode: Delegates small/similar diffs to LLM when more efficient
  • Accuracy Mode: Optional full context including unchanged text (with cost warnings)
  • Cost Transparency: Warns when diff tool costs more than original texts

Quick Setup

Standard Mode (Recommended)

Shows only changes, minimizes token usage:

{
  "mcpServers": {
    "codiff-mcp": {
      "command": "npx",
      "args": ["-y", "codiff-mcp@latest"]
    }
  }
}

Token-Saving Mode

Smart delegation to LLM for efficiency:

{
  "mcpServers": {
    "codiff-mcp": {
      "command": "npx",
      "args": ["-y", "codiff-mcp@latest", "--save-tokens"]
    }
  }
}

Accuracy Mode

⚠️ Includes unchanged text (may increase costs):

{
  "mcpServers": {
    "codiff-mcp": {
      "command": "npx",
      "args": ["-y", "codiff-mcp@latest", "--accuracy"]
    }
  }
}

Usage

The codiff tool compares two text inputs:

  • original: Baseline text
  • modified: Updated text

Modes

ModeFlagsBehavior
Standard(default)Shows only changes, warns about costs
Token-Saving--save-tokens, -sDelegates small/similar diffs to LLM
Accuracy--accuracy, -aIncludes unchanged text ⚠️
Combined-s -aSmart delegation + full context

Examples

Identical Texts

{
  "result": "identical",
  "message": "The provided texts are identical - no differences found.",
  "savings": { "estimatedSavings": 5 }
}

Standard Mode (Changes Only)

{
  "diff": [
    {"type": "delete", "text": "Hello world\n"},
    {"type": "insert", "text": "Hello beautiful world\n"}
  ],
  "mode": "standard",
  "savings": { "estimatedSavings": 5 }
}

Cost Warning

{
  "warnings": [
    "INCREASED COST: This diff costs 5 more tokens than sending the original texts."
  ]
}

Token-Saving Delegation

{
  "result": "delegate_to_llm",
  "message": "For optimal token efficiency, please analyze these texts directly...",
  "recommendation": "Compare manually by scanning for differences..."
}

Auto-Usage Rule

Add to .cursorrules for automatic diffing:

{
  "rules": {
    "general_rules": [
      {
        "description": "When the user requests comparisons, diffs, or change analysis, ALWAYS use the codiff MCP tool first. Use for file comparisons, version analysis, and any request involving 'compare', 'diff', 'changes', or 'differences'.",
        "type": "tool_prioritization_codiff"
      }
    ]
  }
}

Development

npm run start              # Standard mode
npm run start:save-tokens  # Token-saving mode  
npm run start:accuracy    # Accuracy mode
npm run start:full        # Combined mode