Patch File MCP

🚀 ファイルパッチ MCP サーバー

ブロック形式のパッチを適用して既存のファイルを修正するための MCP サーバーです。これにより、Claude などの AI エージェントがプロジェクト内のファイルを正確に変更できます。

🚀 クイックスタート

ファイルパッチ MCP は、ブロック形式のパッチを適用することでファイルを変更するシンプルな方法を提供します。これにより、AI エージェント（Claude など）がプロジェクト内のファイルを正確に変更できます。

✨ 主な機能

• ファイルの特定部分を正確に変更でき、全体を書き直す必要がない
• 1 つのリクエストで同じファイルに複数のパッチを適用できる
• 正確なテキストマッチングと一意性検証により安全性を確保する
• デスクトップコマンダーツール edit_block の代替として、ほとんどのファイル編集タスクに適している

📦 インストール

uvx を使用する方法

この方法では、uvx（uv Python パッケージマネージャーから）を使用して、サーバーを永続的にインストールせずに実行します。

前提条件

uvx をまだインストールしていない場合は、uv からインストールしてください。

MCP クライアント（Claude Desktop、Cursor など）の設定

以下の設定を既存の設定ファイル（例：claude_desktop_config.json）にマージします。

{
  "mcpServers": {
    "patch-file": {
      "command": "uvx",
      "args": [
        "patch-file-mcp",
        "--allowed-dir", "/Users/your-username/projects",
        "--allowed-dir", "/Users/your-username/Documents/code"
      ]
    }
  }
}

⚠️ 重要提示

/Users/your-username を実際のプロジェクトとドキュメントのパスに置き換えてください。

ソースコードからインストールする方法

前提条件

• Python 3.11 以上
• Pip パッケージマネージャー

リポジトリをクローンする

git clone https://github.com/your-username/patch-file-mcp.git
cd patch-file-mcp
python -m venv venv
source venv/bin/activate
pip install -e .

MCP クライアント（Claude Desktop、Cursor など）の設定

以下の設定を既存の設定ファイル（例：claude_desktop_config.json）にマージします。

{
  "mcpServers": {
    "patch-file": {
      "command": "path/to/your/venv/bin/patch-file-mcp",
      "args": [
        "--allowed-dir", "/Users/your-username/projects",
        "--allowed-dir", "/Users/your-username/Documents/code"
      ]
    }
  }
}

⚠️ 重要提示

/Users/your-username を実際のプロジェクトとドキュメントのパスに置き換えてください。

💻 使用例

基本的な使用法

from patch_file import patch_file

patch = """--- a/message.txt
+++ b/message.txt
@@ -1,3 +1,4 @@
 Hello,
 
-This is a test.
+This is a test from
+Claude!
"""

patch_file("message.txt", patch)

高度な使用法

patch_file 関数は、追加のパラメータをサポートしています。例えば、エンコーディングやエラー処理方法を指定できます。

from patch_file import patch_file

patch = """--- a/message.txt
+++ b/message.txt
@@ -1,3 +1,4 @@
 Hello,
 
-This is a test.
+This is a test from
+Claude!
"""

patch_file("message.txt", patch, encoding='utf-8', errors='ignore')

📚 ドキュメント

パラメータ

--allowed-dir パラメータは、サーバーがアクセスできるディレクトリを指定するために使用されます。複数のディレクトリを許可するために複数回使用できます。すべての許可されたディレクトリのサブディレクトリも許可されます。これはオプションのパラメータで、指定されない場合、サーバーはサーバーを実行しているユーザーのホームディレクトリにのみアクセスできます。

パッチ形式

パッチ内容は標準の diff 形式を使用する必要があります。例えば：

--- a/file.txt
+++ b/file.txt
@@ -1,3 +1,4 @@
 Hello,
 
-This is a test.
+This is a test from
+Claude!

🔧 技術詳細

セキュリティに関する考慮事項

• ファイル操作制限：デフォルトでは、サーバーは実行ディレクトリと --allowed-dir パラメータで指定されたディレクトリにのみアクセスできます。
• テキストマッチングの一意性：各パッチブロックは、ターゲットファイルの内容に一意に対応する必要があり、意図しない上書きや競合を避けます。
• エラー報告：詳細なエラー情報は、パッチ適用の失敗をデバッグするのに役立ちます。

依存関係

• fastapi（>=0.68.0，<1.0.0）
• uvicorn（>=0.15.0，<1.0.0）

📄 ライセンス

MIT