Skip to main content
Glama
deenesjakoruzh
possible055

Relace MCP Server

by possible055
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

Inoffizieller Relace MCP-Server

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

Inoffiziell — Persönliches Projekt, nicht mit Relace verbunden.

Mit KI erstellt — Vollständig mit KI-Unterstützung entwickelt (Antigravity, Codex, Cursor, Github Copilot, Windsurf).

MCP-Server, der KI-gestützte Code-Bearbeitung und intelligente Werkzeuge zur Erkundung der Codebasis bereitstellt.

Ohne

Mit agentic_search + fast_apply

Manuelles Grep, übersieht verwandte Dateien

Natürlich fragen, präzise Orte erhalten

Bearbeitungen zerstören Importe an anderer Stelle

Verfolgt Importe und Aufrufketten

Vollständiges Umschreiben verbraucht Token

Änderungen beschreiben, keine Zeilennummern

Zeilennummernfehler beschädigen Code

10.000+ Token/Sek. Zusammenführung

Funktionen

  • Fast Apply — Code-Bearbeitungen mit über 10.000 Token/Sek. über die Relace-API anwenden

  • Agentic Search — Agentische Codebase-Erkundung mit natürlichsprachlichen Abfragen

  • Agentic Retrieval — Hybride semantische Hinweise + Live-Code-Erkundung, mit Unterstützung für veraltete Hinweise und expliziter Cloud-Wartung (aktivieren mit MCP_SEARCH_RETRIEVAL=1; wählen Sie das Backend mit MCP_RETRIEVAL_BACKEND)

  • Cloud Search — Semantische Codesuche über in der Cloud synchronisierte Repositories

Related MCP server: GraphHub

Schnellstart

Voraussetzungen: uv, git, ripgrep (empfohlen)

Verwendung des relace-Backends (Standard): Holen Sie sich Ihren API-Schlüssel vom Relace Dashboard und fügen Sie ihn dann Ihrem MCP-Client hinzu:

~/.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"

Konfiguration

Variable

Erforderlich

Beschreibung

RELACE_API_KEY

✅*

API-Schlüssel vom Relace Dashboard; erforderlich für Relace-Anbieter und Cloud-Tools

MCP_SEARCH_RETRIEVAL

❌

Auf 1 setzen, um das agentic_retrieval-Tool zu registrieren

MCP_RETRIEVAL_BACKEND

❌

Semantisches Retrieval-Backend: relace (Standard), codanna, chunkhound oder none

MCP_RETRIEVAL_HINT_POLICY

❌

Retrieval-Hinweis-Richtlinie: prefer-stale (Standard) oder strict

MCP_BACKGROUND_INDEX_MONITOR

❌

Optionaler periodischer Aktualisierungsmonitor für lokale Indizes; erfordert ein fixiertes MCP_BASE_DIR und ein lokales Backend

MCP_BACKGROUND_INDEX_INTERVAL_SECONDS

❌

Intervall für den periodischen lokalen Indexmonitor in Sekunden (Standard: 300)

MCP_BACKGROUND_INDEX_INITIAL_DELAY_SECONDS

❌

Anfängliche Verzögerung vor der ersten periodischen lokalen Indexprüfung in Sekunden (Standard: 30)

MCP_SEARCH_TURN_STATUS_MODE

❌

Richtlinie für Turn-Status-Benutzernachrichten: always (Standard), final-only oder off

SEARCH_BASH_TOOLS

❌

bash während Suchläufen aktivieren: 1 (an, Standard), 0 (aus)

SEARCH_LSP_TOOLS

❌

LSP-unterstützte Suche aktivieren: 1 (an), 0 (aus, Standard)

MCP_BASE_DIR

❌

Überschreibung des Projekt-Roots (automatisch erkannt über MCP Roots → Git → Workspace-Speicher → CWD)

MCP_LOGGING

❌

Dateiprotokollierung: off (Standard), safe, full

MCP_DOTENV_PATH

❌

Pfad zur .env-Datei für zentralisierte Konfiguration

* Optional, wenn beides zutrifft: (1) APPLY_PROVIDER und SEARCH_PROVIDER sind keine Relace-Anbieter, und (2) MCP_RETRIEVAL_BACKEND ist codanna, chunkhound oder none.

Für die Verwendung von .env, Kodierungseinstellungen, benutzerdefinierte LLM-Anbieter und mehr, siehe docs/advanced.md.

Werkzeuge

Immer verfügbar: fast_apply, agentic_search. agentic_retrieval erfordert MCP_SEARCH_RETRIEVAL=1. Cloud-Tools sind nur verfügbar, wenn MCP_RETRIEVAL_BACKEND=relace. index_status ist für relace, codanna und chunkhound verfügbar und ausgeblendet, wenn MCP_RETRIEVAL_BACKEND=none.

Verwenden Sie MCP-native Erkennungsoberflächen: list_tools() für Werkzeuge und list_resources() für Ressourcen.

Für detaillierte Parameter siehe docs/tools.md.

Sprachunterstützung

LSP-Werkzeuge verwenden externe Sprachserver, die auf Ihrem System installiert sind.

Sprache

Sprachserver

Installationsbefehl

Python

basedpyright

(gebündelt)

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

Dashboard

Echtzeit-Terminal-UI zur Überwachung von Vorgängen.

pip install relace-mcp[tools]
relogs

Für eine detaillierte Nutzung siehe docs/dashboard.md.

Benchmark

Bewerten Sie die Leistung von agentic_search mithilfe des Loc-Bench Code-Lokalisierungs-Datensatzes.

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

Alle Benchmark-Artefakte werden unter benchmark/.data/ geschrieben.

Für Rastersuche, Analysewerkzeuge und Metrikeninterpretation siehe docs/benchmark.md.

Plattformunterstützung

Plattform

Status

Hinweise

Linux

✅ Voll unterstützt

Primäre Entwicklungsplattform

macOS

✅ Voll unterstützt

Alle Funktionen verfügbar

Windows

⚠️ Teilweise

bash-Werkzeug nicht verfügbar; verwenden Sie WSL für volle Funktionalität

Fehlerbehebung

Fehler oder Nachricht

Lösung

RELACE_API_KEY is required ...

Setzen Sie RELACE_API_KEY bei Verwendung von Relace-Anbietern oder Cloud-Tools

NEEDS_MORE_CONTEXT

Fügen Sie 1-3 eindeutige Ankerzeilen in der Nähe des Zielblocks ein

INVALID_PATH

Überprüfen Sie, ob der Pfad existiert und sich innerhalb von MCP_BASE_DIR oder einem erlaubten zusätzlichen Pfad befindet

FILE_TOO_LARGE

Datei überschreitet 10 MB; teilen Sie die Änderung in kleinere Dateien oder Bearbeitungen auf

ENCODING_ERROR

Setzen Sie RELACE_DEFAULT_ENCODING explizit für Nicht-UTF-8-Projekte

AUTH_ERROR

Überprüfen Sie den API-Schlüssel und die Anbieterkonfiguration

RATE_LIMIT

Versuchen Sie es später erneut oder reduzieren Sie das Anfragevolumen

NETWORK_ERROR / TIMEOUT_ERROR

Überprüfen Sie den Netzwerkzugriff und versuchen Sie es erneut

APPLY_NOOP

Fügen Sie spezifischere Anker oder konkrete neue Zeilen hinzu, damit die Zusammenführung ein Diff erzeugen kann

MARKER_LEAKAGE

Stellen Sie sicher, dass Platzhaltermarkierungen nur als Platzhalter verwendet werden, nicht als erwartete wörtliche Ausgabe

TRUNCATION_DETECTED

Teilen Sie große, löschintensive Bearbeitungen auf oder verwenden Sie explizite Entfernungsanweisungen

BLAST_RADIUS_EXCEEDED

Unterteilen Sie die Änderung in kleinere, lokalere Bearbeitungen

Entwicklung

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

Lizenz

MIT

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

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.

Tools

Related MCP Servers

  • Portable MCP Toolkit

    mjdevaccount
    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

  • context-mcp

    vibhasdutta
    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

  • code-context

    jieyefriic
    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

  • kansei-mcp-server

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

  • Maguyva

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

  • Ragora

    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