Edit MCP

🚀 Edit - MCP：適用於微軟Edit的模型上下文協議服務器

Edit - MCP是一個模型上下文協議（MCP）服務器，它與微軟的Edit工具集成，為AI系統提供高級文件編輯功能。它採用混合架構，將用於提升性能的直接文件系統操作與用於處理複雜編輯任務的微軟Edit集成相結合。

🚀 快速開始

Edit - MCP服務器在AI系統和文件編輯操作之間充當著精密的協調者。它公開了一個標準化的MCP接口，允許AI模型執行以下操作：

• 讀寫文件
• 搜索和替換文本
• 格式化代碼
• 執行復雜的編輯操作
• 協調多文件編輯
• 以及更多...

✨ 主要特性

Edit - MCP採用混合架構，包含以下組件：

1. 核心MCP服務器

• 處理MCP協議通信
• 將操作路由到適當的子系統
• 管理文件狀態和元數據
• 在多個Edit實例之間進行協調
• 提供緩存和優化

2. 文件系統管理器

• 為簡單任務執行直接文件操作
• 處理基本的CRUD操作
• 提供文本搜索和簡單的查找替換功能
• 管理文件元數據操作
• 支持跨多個文件的批量操作

3. Edit實例管理器

• 為複雜操作管理微軟Edit進程
• 處理複雜的編輯場景
• 協調多文件操作
• 以編程方式管理Edit的TUI交互

4. 操作路由器

• 決定每個操作由哪個子系統處理
• 將簡單操作路由到文件系統管理器
• 將複雜操作路由到Edit實例管理器
• 協調兩個子系統之間的混合操作

📦 安裝指南

前提條件

• Node.js 16或更高版本
• 已安裝微軟Edit，並且其可執行文件已添加到系統的PATH環境變量中

從源代碼安裝

# 克隆倉庫
git clone https://github.com/mixelpixx/edit-mcp.git
cd edit-mcp

# 安裝依賴
npm install

# 構建項目
npm run build

💻 使用示例

啟動服務器

你可以使用stdio或HTTP傳輸協議來啟動Edit - MCP服務器：

# 使用stdio傳輸協議啟動（用於與AI系統直接集成）
npm run stdio

# 使用HTTP傳輸協議啟動（用於基於Web的集成）
npm run http

命令行選項

用法: edit-mcp [選項]

選項:
  -V, --version                輸出版本號
  -p, --port <port>            HTTP傳輸協議監聽的端口（默認值："3000"）
  -e, --edit-path <path>       Edit可執行文件的路徑
  -m, --max-instances <number> Edit實例的最大數量（默認值："5"）
  -t, --timeout <milliseconds> Edit實例的超時時間（以毫秒為單位，默認值："300000"）
  -c, --config <path>          配置文件的路徑
  -d, --debug                  啟用調試日誌
  -s, --stdio                  使用stdio傳輸協議而非HTTP
  -h, --help                   顯示命令幫助信息

配置

你可以使用JSON配置文件來配置Edit - MCP：

{
  "editExecutable": "/path/to/edit",
  "maxEditInstances": 5,
  "instanceTimeout": 300000,
  "simpleOperationThreshold": 1000,
  "complexityFactors": {
    "fileSize": 0.3,
    "operationType": 0.4,
    "contextRequirement": 0.3
  }
}

可用工具

Edit - MCP提供以下工具：

文件系統工具

• read_file：讀取文件內容
• write_file：將內容寫入文件
• list_files：列出目錄中的文件
• find_in_file：在文件中查找模式的出現位置

Edit工具

• format_code：格式化文件中的代碼
• complex_find_replace：執行高級查找和替換操作
• interactive_edit_session：啟動交互式編輯會話

混合工具

• smart_refactor：智能地跨多個文件重構代碼
• backup_and_edit：在編輯文件之前創建文件備份

HTTP傳輸

Edit - MCP現在除了支持stdio之外，還支持HTTP傳輸，允許遠程訪問和使用REST API端點。

使用HTTP傳輸啟動

# 使用默認HTTP端口（3000）啟動
edit-mcp

# 使用自定義端口啟動
edit-mcp --port 8080

# 使用配置文件啟動
edit-mcp --config config.http.example.json

REST API端點

健康檢查

GET /health

JSON - RPC端點

POST /jsonrpc
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "read_file",
    "arguments": {
      "path": "example.txt"
    }
  },
  "id": 1
}

其他REST API端點

• GET /api/tools - 列出可用工具
• POST /api/tools/:toolName - 調用特定工具
• GET /api/files/:path - 讀取文件內容
• PUT /api/files/:path - 寫入文件內容
• GET /api/list/:directory - 列出目錄中的文件
• POST /api/search - 在文件中搜索模式
• POST /api/format - 格式化代碼
• POST /api/refactor - 跨文件重構符號
• GET /api/docs - API文檔

身份驗證

通過在配置中設置authEnabled: true來啟用API密鑰身份驗證：

{
  "authEnabled": true,
  "apiKey": "your-secure-api-key"
}

在請求中包含API密鑰：

• 請求頭：X - API - Key: your-secure-api-key
• 查詢參數：?apiKey=your-secure-api-key

CORS配置

在配置文件中配置允許的源：

{
  "corsOrigins": ["http://localhost:*", "https://yourdomain.com"]
}

速率限制

配置速率限制以防止濫用：

{
  "rateLimitWindowMs": 900000,  // 15分鐘
  "rateLimitMax": 100           // 每個窗口100個請求
}

📚 詳細文檔

開發

構建項目

# 構建項目
npm run build

# 監聽更改並重新構建
npm run watch

在開發模式下運行

# 開啟熱重載運行
npm run dev

📄 許可證

本項目採用MIT許可證。

致謝

• 感謝微軟提供的Edit工具
• 感謝模型上下文協議社區