Skip to main content
Glama
possible055

Relace MCP Server

by possible055

Servidor MCP de Relace (No oficial)

PyPI Python 3.11+ License: MIT 100% AI-Generated OpenSSF Scorecard

No oficial — Proyecto personal, no afiliado a Relace.

Creado con IA — Desarrollado completamente con asistencia de IA (Antigravity, Codex, Cursor, Github Copilot, Windsurf).

Servidor MCP que proporciona herramientas de edición de código impulsadas por IA y exploración inteligente de bases de código.

Sin

Con agentic_search + fast_apply

Grep manual, pierde archivos relacionados

Pregunta de forma natural, obtén ubicaciones precisas

Las ediciones rompen importaciones en otros lugares

Rastrea importaciones y cadenas de llamadas

Las reescrituras completas consumen tokens

Describe cambios, sin números de línea

Los errores de número de línea corrompen el código

Fusión a más de 10,000 tokens/seg

Características

  • Fast Apply — Aplica ediciones de código a más de 10,000 tokens/seg mediante la API de Relace

  • Agentic Search — Exploración de bases de código mediante agentes con consultas en lenguaje natural

  • Agentic Retrieval — Sugerencias semánticas híbridas + exploración de código en vivo, con soporte para sugerencias obsoletas y mantenimiento explícito en la nube (habilítalo con MCP_SEARCH_RETRIEVAL=1; elige el backend con MCP_RETRIEVAL_BACKEND)

  • Cloud Search — Búsqueda semántica de código en repositorios sincronizados en la nube

Related MCP server: GraphHub

Inicio rápido

Requisitos previos: uv, git, ripgrep (recomendado)

Usando el backend relace (predeterminado): obtén tu clave de API desde el Panel de control de Relace, luego agrégala a tu cliente MCP:

~/.cursor/mcp.json

{
  "mcpServers": {
    "relace": {
      "command": "uv",
      "args": ["tool", "run", "relace-mcp"],
      "env": {
        "RELACE_API_KEY": "rlc-your-api-key",
        "MCP_BASE_DIR": "/absolute/path/to/your/project"
      }
    }
  }
}
claude mcp add relace \
  --env RELACE_API_KEY=rlc-your-api-key \
  --env MCP_BASE_DIR=/absolute/path/to/your/project \
  -- uv tool run relace-mcp

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "relace": {
      "command": "uv",
      "args": ["tool", "run", "relace-mcp"],
      "env": {
        "RELACE_API_KEY": "rlc-your-api-key",
        "MCP_BASE_DIR": "/absolute/path/to/your/project"
      }
    }
  }
}

.vscode/mcp.json

{
  "mcp": {
    "servers": {
      "relace": {
        "type": "stdio",
        "command": "uv",
        "args": ["tool", "run", "relace-mcp"],
        "env": {
          "RELACE_API_KEY": "rlc-your-api-key",
          "MCP_BASE_DIR": "${workspaceFolder}"
        }
      }
    }
  }
}

~/.codex/config.toml

[mcp_servers.relace]
command = "uv"
args = ["tool", "run", "relace-mcp"]

[mcp_servers.relace.env]
RELACE_API_KEY = "rlc-your-api-key"
MCP_BASE_DIR = "/absolute/path/to/your/project"

Configuración

Variable

Requerido

Descripción

RELACE_API_KEY

*

Clave de API del Panel de control de Relace; requerida para proveedores de Relace y herramientas en la nube

MCP_SEARCH_RETRIEVAL

Establecer en 1 para registrar la herramienta agentic_retrieval

MCP_RETRIEVAL_BACKEND

Backend de recuperación semántica: relace (predeterminado), codanna, chunkhound o none

MCP_RETRIEVAL_HINT_POLICY

Política de sugerencias de recuperación: prefer-stale (predeterminado) o strict

MCP_BACKGROUND_INDEX_MONITOR

Monitor de actualización periódica opcional para índices locales; requiere un MCP_BASE_DIR fijado y un backend local

MCP_BACKGROUND_INDEX_INTERVAL_SECONDS

Intervalo del monitor de índice local periódico en segundos (predeterminado: 300)

MCP_BACKGROUND_INDEX_INITIAL_DELAY_SECONDS

Retraso inicial antes de la primera comprobación periódica del índice local en segundos (predeterminado: 30)

MCP_SEARCH_TURN_STATUS_MODE

Política de mensajes de usuario sobre el estado del turno: always (predeterminado), final-only o off

SEARCH_BASH_TOOLS

Habilitar bash durante las ejecuciones de búsqueda: 1 (encendido, predeterminado), 0 (apagado)

SEARCH_LSP_TOOLS

Habilitar búsqueda asistida por LSP: 1 (encendido), 0 (apagado, predeterminado)

MCP_BASE_DIR

Anulación de la raíz del proyecto (detectada automáticamente mediante MCP Roots → Git → almacenamiento del espacio de trabajo → CWD)

MCP_LOGGING

Registro en archivo: off (predeterminado), safe, full

MCP_DOTENV_PATH

Ruta al archivo .env para una configuración centralizada

* Opcional si ambos: (1) APPLY_PROVIDER y SEARCH_PROVIDER no son proveedores de Relace, y (2) MCP_RETRIEVAL_BACKEND es codanna, chunkhound o none.

Para el uso de .env, configuraciones de codificación, proveedores de LLM personalizados y más, consulta docs/advanced.md.

Herramientas

Siempre disponibles: fast_apply, agentic_search. agentic_retrieval requiere MCP_SEARCH_RETRIEVAL=1. Las herramientas en la nube están disponibles solo cuando MCP_RETRIEVAL_BACKEND=relace. index_status está disponible para relace, codanna y chunkhound, y se oculta cuando MCP_RETRIEVAL_BACKEND=none.

Utiliza las superficies de descubrimiento nativas de MCP: list_tools() para herramientas y list_resources() para recursos.

Para parámetros detallados, consulta docs/tools.md.

Soporte de idiomas

Las herramientas LSP utilizan servidores de lenguaje externos instalados en tu sistema.

Idioma

Servidor de lenguaje

Comando de instalación

Python

basedpyright

(incluido)

TypeScript/JS

typescript-language-server

npm i -g typescript-language-server typescript

Go

gopls

go install golang.org/x/tools/gopls@latest

Rust

rust-analyzer

rustup component add rust-analyzer

Panel de control

Interfaz de terminal en tiempo real para monitorear operaciones.

pip install relace-mcp[tools]
relogs

Para un uso detallado, consulta docs/dashboard.md.

Benchmark

Evalúa el rendimiento de agentic_search utilizando el conjunto de datos de localización de código Loc-Bench.

git clone https://github.com/possible055/relace-mcp.git
cd relace-mcp
uv sync --extra benchmark

# Build dataset from Hugging Face
uv run --extra benchmark python -m benchmark.cli.build_locbench --output artifacts/data/raw/locbench_v1.jsonl

# Run evaluation
uv run --extra benchmark python -m benchmark.cli.run --dataset artifacts/data/raw/locbench_v1.jsonl --limit 20

Todos los artefactos de benchmark se escriben en benchmark/.data/.

Para búsqueda en cuadrícula, herramientas de análisis e interpretación de métricas, consulta docs/benchmark.md.

Soporte de plataforma

Plataforma

Estado

Notas

Linux

✅ Totalmente compatible

Plataforma de desarrollo principal

macOS

✅ Totalmente compatible

Todas las funciones disponibles

Windows

⚠️ Parcial

Herramienta bash no disponible; usa WSL para una funcionalidad completa

Solución de problemas

Error o mensaje

Solución

RELACE_API_KEY is required ...

Establece RELACE_API_KEY al usar proveedores de Relace o herramientas en la nube

NEEDS_MORE_CONTEXT

Incluye 1-3 líneas de anclaje únicas cerca del bloque de destino

INVALID_PATH

Verifica que la ruta exista y esté dentro de MCP_BASE_DIR o una ruta adicional permitida

FILE_TOO_LARGE

El archivo supera los 10MB; divide el cambio en archivos o ediciones más pequeños

ENCODING_ERROR

Establece RELACE_DEFAULT_ENCODING explícitamente para proyectos que no sean UTF-8

AUTH_ERROR

Verifica la clave de API y la configuración del proveedor

RATE_LIMIT

Vuelve a intentarlo más tarde o reduce el volumen de solicitudes

NETWORK_ERROR / TIMEOUT_ERROR

Comprueba el acceso a la red y vuelve a intentarlo

APPLY_NOOP

Agrega anclajes más específicos o nuevas líneas concretas para que la fusión pueda producir una diferencia

MARKER_LEAKAGE

Asegúrate de que los marcadores de posición se utilicen solo como marcadores, no como salida literal esperada

TRUNCATION_DETECTED

Divide las ediciones grandes con muchas eliminaciones o usa directivas de eliminación explícitas

BLAST_RADIUS_EXCEEDED

Divide el cambio en ediciones más pequeñas y locales

Desarrollo

git clone https://github.com/possible055/relace-mcp.git
cd relace-mcp
uv sync --extra dev --extra benchmark
uv run pytest
uv run --extra dev --extra benchmark pytest benchmark/tests -q

Licencia

MIT

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
1wRelease cycle
4Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides AI-powered code intelligence for any codebase using local LLMs and vector search, enabling semantic code search, pattern analysis, and context-optimized code generation with 90% token savings.
    2
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Provides persistent memory and a codebase knowledge graph for AI coding assistants, enabling shared context across multiple tools like Claude, Cursor, and ChatGPT, with significant token reduction.
    5
    32
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI coding assistants to automatically scan, store, and query API endpoints from codebases, providing instant lookup and semantic search to reduce context switching and token consumption.
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • SaaS intelligence for AI agents. 5 unified tools cover 1,000+ services with 91-96% token savings.

  • Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.

  • Search your knowledge bases from any AI assistant using hybrid RAG.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/possible055/relace-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server