MCP Edit File Lines

🚀 編集ファイルツール使用ドキュメント

このツールはMCPプロトコルに従い、ファイルの編集に使用されます。以下に主な機能と特性を示します。

• セキュリティ制限：すべてのファイル操作は事前に指定された許可ディレクトリに限定されます。
• スマートテキスト処理：正規表現と文字列のマッチングをサポートします。
• バージョン管理：編集状態の保存と復元をサポートします。
• 検証メカニズム：ファイルパスと修正内容を厳密に検証します。

📦 インストール

依存関係のインストール

必要な依存関係をインストールするには、以下のコマンドを実行します。

npm install

サーバーのビルド

本番環境用のサーバーをビルドします。

npm run build

開発モード

開発環境で自動再構築機能を有効にします。

npm run watch

🚀 クイックスタート

サーバーを起動する際には、1つまたは複数の許可ディレクトリを指定する必要があります。

node build/index.js <許可ディレクトリ> [追加ディレクトリ...]

すべてのファイル操作はこれらの指定されたディレクトリに限定されます。

環境変数

• MCP_EDIT_STATE_TTL：編集状態のタイムアウト時間（ミリ秒）で、デフォルト値は60000です。

💻 使用例

基本的な使用法

例1：特定の行の内容を置き換える

{
  "path": "src/components/Button.tsx",
  "edits": [{
    "startLine": 5,
    "endLine": 5,
    "content": "export const Button = () => {"
  }]
}

例2：複数の位置を一括で修正する

{
  "operations": [
    {
      "path": "src/App.tsx",
      "edits": [{
        "startLine": 10,
        "endLine": 10,
        "content": "// 新注释"
      }]
    },
    {
      "path": "src/styles.css",
      "edits": [{
        "startLine": 20,
        "endLine": 20,
        "content": ".button { padding: 1rem; }"
      }]
    }
  ]
}

🔧 エラー処理

一般的なエラーとその解決策を以下に示します。

1. マッチする項目が見つからない

Error: 没有找到字符串匹配项"oldValue"在第5行

2. 無効な正規表現

Error: 无效的正则表达式模式"([": 未终止的分组

3. 同一行が複数回編集される

Error: 第5行受到多个编辑操作的影响

⚠️ セキュリティに関する注意事項

• すべてのファイル操作は事前に指定された許可ディレクトリに限定されます。
• symlinkを使用してパス制限を回避することは禁止されています。
• 親ディレクトリのトラバーサル攻撃を防ぎます。
• 入力されたファイルパスと修正内容を厳密に検証します。
• 編集状態はデフォルトで60秒後に自動的に期限切れになります。

🛠️ デバッグガイド

test:toolsスクリプトを使用してツールを全面的にテストすることをおすすめします。

npm run test:tools

このスクリプトは以下のことを行います。

1. テストケースを初期状態にリセットします。
2. MCPサーバーに接続します。
3. 各機能モジュールを順次テストします。
4. 各操作の出力結果を表示します。

⚙️ 設定例

Claude環境での設定例を以下に示します。

export MCP_EDIT_STATE_TTL=360000

🆘 ヘルプとサポート

ヘルプが必要な場合や問題を発見した場合は、技術サポートチームにお問い合わせください。