Microsoft Edit MCP

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

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

🚀 快速開始

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

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

✨ 主要特性

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

1. 核心MCP服務器

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

2. 文件系統管理器

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

3. Edit實例管理器

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

4. 操作路由器

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

📦 安裝指南

前提條件

• Node.js 16或更高版本
• 已安裝微軟Edit並將其添加到系統路徑中

從源碼安裝

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

# 安裝依賴
npm install

# 構建項目
npm run build

💻 使用示例

啟動服務器

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

# 使用stdio傳輸啟動（用於與人工智能系統直接集成）
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工具
• 感謝模型上下文協議社區