项目简介
Relace MCP 服务器是一个基于 Model Context Protocol (MCP) 的代码编辑工具,利用 Relace 云服务的强大能力,为 AI 助手提供快速、安全的代码修改和搜索能力。
主要功能
- 快速应用编辑:通过 Relace API 以每秒 10,000+ tokens 的速度执行代码编辑
- 智能代码搜索:通过代理式搜索智能探索代码库,理解代码结构和关系
安装步骤
- 安装 Python 3.12+ 和 uv 包管理器
- 从 Relace 仪表板获取 API 密钥
- 在 MCP 客户端配置中添加以下内容:
{ "mcpServers": { "relace": { "command": "uv", "args": ["tool", "run", "relace-mcp"], "env": { "RELACE_API_KEY": "rlc-your-api-key", "RELACE_BASE_DIR": "/absolute/path/to/your/project" } } }
配置参数说明:
- 'command': 使用 uv 包管理器运行
- 'args': 指定运行 relace-mcp 工具
- 'RELACE_API_KEY": Relace 云服务的认证密钥
- 'RELACE_BASE_DIR": 项目根目录的绝对路径(用于限制文件访问范围)
基本使用方法
- 编辑文件:使用 'fast_apply' 工具,提供文件路径和编辑片段
- 搜索代码库:使用 'fast_search' 工具进行自然语言查询
- 安全特性:内置路径遍历防护、文件大小限制、命令黑名单等安全机制
重要提示:
- 必须设置 'RELACE_BASE_DIR' 为绝对路径
- 编辑片段应包含定位锚点(如 '// ... existing code ...')
- 支持创建新文件和编辑现有文件
- 提供详细的错误处理和日志记录
信息
分类
开发者工具