Codiff MCP

Codiff MCP服务器

一种用于智能文本区分和令牌优化的模型上下文协议（MCP）服务器。

特性

• 智能变化检测：默认情况下仅显示插入/删除以最小化标记
• 相同文本优化：对于相同的文本，立即返回“相同”
• 令牌保存模式：当效率更高时，将小/类似的差异委托给LLM
• 精度模式：可选的完整上下文，包括未更改的文本（带有成本警告）
• 成本透明度：当diff工具的成本高于原始文本时发出警告

快速设置

标准模式（推荐）

仅显示更改，最大限度地减少令牌使用：

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

令牌保存模式

明智地委派LLM以提高效率：

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

精度模式

⚠️ 包括未更改的文本（可能会增加成本）：

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

用法

这 codiff 该工具比较两个文本输入：

• original：基线文本
• modified：更新文本

模式

例子

相同的文本

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

标准模式（仅更改）

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

成本警告

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

代币保存委托

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

自动使用规则

增添 .cursorrules 对于自动差速器：

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

发展

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