Edit MCP:Microsoft Edit的模型上下文协议服务器
Edit MCP是一个模型上下文协议（MCP）服务器，与微软的Edit工具集成，为人工智能系统提供高级文件编辑功能。它遵循一种混合架构，将直接文件系统操作与Microsoft Edit集成相结合，以实现复杂的编辑任务。
概述
Edit MCP服务器充当人工智能系统和文件编辑操作之间的复杂协调器。它公开了一个标准化的MCP接口，允许AI模型：
- 读取和写入文件
- 搜索和替换文本
- 格式代码
- 执行复杂的编辑操作
- 协调多文件编辑
- 还有更多。..
建筑
Edit MCP遵循混合架构，包含以下组件：
1.核心MCP服务器
- 处理MCP协议通信
- 将操作路由到适当的子系统
- 管理文件状态和元数据
- 多个Edit实例之间的坐标
- 提供缓存和优化
2.文件系统管理器
- 对简单任务执行直接文件操作
- 处理基本的CRUD操作
- 提供文本搜索和简单的查找/替换
- 管理文件元数据操作
- 支持跨多个文件的批处理操作
3.编辑实例管理器
- 管理Microsoft Edit流程以进行复杂操作
- 处理复杂的编辑场景
- 协调多文件操作
- 以编程方式管理Edit的TUI交互
4.操作路由器
- 决定哪个子系统处理每个操作
- 将简单操作路由到文件系统管理器
- 将复杂操作路由到编辑实例管理器
- 协调两个子系统之间的混合操作
安装
先决条件
- Node.js 16或更高版本
- Microsoft Edit已安装并可在PATH中使用
从源代码安装
# Clone the repository
git clone https://github.com/mixelpixx/edit-mcp.git
cd edit-mcp
# Install dependencies
npm install
# Build the project
npm run build用法
启动服务器
您可以使用stdio或HTTP传输启动Edit MCP服务器：
# Start with stdio transport (for direct integration with AI systems)
npm run stdio
# Start with HTTP transport (for web-based integration)
npm run http命令行选项
Usage: edit-mcp [options]
Options:
-V, --version output the version number
-p, --port
Port to listen on for HTTP transport (default: "3000")
-e, --edit-path
Path to the Edit executable
-m, --max-instances Maximum number of Edit instances (default: "5")
-t, --timeout Timeout for Edit instances in milliseconds (default: "300000")
-c, --config
Path to configuration file
-d, --debug Enable debug logging
-s, --stdio Use stdio transport instead of HTTP
-h, --help display help for command配置
您可以使用JSON配置文件配置Edit MCP：
{
"editExecutable": "/path/to/edit",
"maxEditInstances": 5,
"instanceTimeout": 300000,
"simpleOperationThreshold": 1000,
"complexityFactors": {
"fileSize": 0.3,
"operationType": 0.4,
"contextRequirement": 0.3
}
}可用工具
编辑MCP提供以下工具：
文件系统工具
read_file：读取文件内容write_file：将内容写入文件list_files：列出目录中的文件find_in_file：查找文件中出现的模式
编辑工具
format_code：文件中的格式代码complex_find_replace：执行高级查找和替换操作interactive_edit_session：启动交互式编辑会话
混合工具
smart_refactor：跨多个文件智能重构代码backup_and_edit：在编辑文件之前创建文件备份
HTTP传输
除了stdio之外，Edit-MCP现在还支持HTTP传输，允许远程访问和REST API端点。
从HTTP传输开始
# Start with default HTTP port (3000)
edit-mcp
# Start with custom port
edit-mcp --port 8080
# Start with configuration file
edit-mcp --config config.http.example.jsonREST API端点
健康检查
GET /healthJSON-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文件
认证
通过设置启用API密钥身份验证 authEnabled: true 在您的配置中：
{
"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 minutes
"rateLimitMax": 100 // 100 requests per window
}发展
建设项目
# Build the project
npm run build
# Watch for changes and rebuild
npm run watch以开发模式运行
# Run with hot reloading
npm run dev许可证
麻省理工学院
致谢
- Microsoft的编辑工具
- 模型上下文协议社区