MCP Edit File Lines

🚀 編輯文件工具使用文檔

本工具遵循MCP協議，專為文件編輯而設計。它能有效解決文件編輯過程中的安全、靈活處理及版本管理等問題，為用戶提供安全、智能且高效的文件編輯體驗。

🚀 快速開始

啟動該編輯文件工具前，需完成依賴安裝、服務器構建等操作，同時要指定允許操作的目錄。

✨ 主要特性

• 安全限制：所有文件操作均嚴格限定在預先指定的允許目錄內，保障操作安全。
• 智能文本處理：支持正則表達式和字符串匹配，讓文本處理更靈活高效。
• 版本控制：支持保存和恢復編輯狀態，方便用戶回溯操作。
• 校驗機制：對文件路徑和修改內容進行嚴格驗證，確保操作的準確性。

📦 安裝指南

安裝依賴

運行以下命令安裝所需依賴：

npm install

構建服務器

構建生產環境版本的服務器：

npm run build

開發模式

在開發環境中啟用自動重建功能：

npm run watch

💻 使用示例

基礎用法

啟動服務器時，需指定一個或多個允許目錄：

node build/index.js <允許目錄> [額外目錄...]

所有文件操作都將被限制在這些指定的目錄內。

高級用法

示例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

幫助與支持

如需幫助或發現任何問題，請聯繫技術支持團隊。