项目简介

Relace MCP 服务器是一个基于 Model Context Protocol (MCP) 的代码编辑工具,利用 Relace 云服务的强大能力,为 AI 助手提供快速、安全的代码修改和搜索能力。

主要功能

  • 快速应用编辑:通过 Relace API 以每秒 10,000+ tokens 的速度执行代码编辑
  • 智能代码搜索:通过代理式搜索智能探索代码库,理解代码结构和关系

安装步骤

  1. 安装 Python 3.12+ 和 uv 包管理器
  2. 从 Relace 仪表板获取 API 密钥
  3. 在 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": 项目根目录的绝对路径(用于限制文件访问范围)

基本使用方法

  1. 编辑文件:使用 'fast_apply' 工具,提供文件路径和编辑片段
  2. 搜索代码库:使用 'fast_search' 工具进行自然语言查询
  3. 安全特性:内置路径遍历防护、文件大小限制、命令黑名单等安全机制

重要提示:

  • 必须设置 'RELACE_BASE_DIR' 为绝对路径
  • 编辑片段应包含定位锚点(如 '// ... existing code ...')
  • 支持创建新文件和编辑现有文件
  • 提供详细的错误处理和日志记录

信息

分类

开发者工具