Skip to main content
Glama
deenesjakoruzh
possible055

Relace MCP Server

by possible055
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

Неофициальный MCP-сервер Relace

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

Неофициальный — личный проект, не связанный с Relace.

Создан с помощью ИИ — разработан полностью при поддержке ИИ (Antigravity, Codex, Cursor, Github Copilot, Windsurf).

MCP-сервер, предоставляющий инструменты для редактирования кода с помощью ИИ и интеллектуального исследования кодовой базы.

Без него

С agentic_search + fast_apply

Ручной grep, пропуск связанных файлов

Естественный запрос, точное местоположение

Правки ломают импорты в других местах

Отслеживание импортов и цепочек вызовов

Полная переписка тратит токены

Описание изменений, без номеров строк

Ошибки в номерах строк портят код

Слияние со скоростью 10 000+ токенов/сек

Возможности

  • Fast Apply — применение правок кода со скоростью 10 000+ токенов/сек через API Relace

  • Agentic Search — агентское исследование кодовой базы с помощью запросов на естественном языке

  • Agentic Retrieval — гибридные семантические подсказки + исследование кода в реальном времени, с поддержкой устаревших подсказок и явным облачным обслуживанием (включите через MCP_SEARCH_RETRIEVAL=1; выберите бэкенд через MCP_RETRIEVAL_BACKEND)

  • Cloud Search — семантический поиск по коду в облачных репозиториях

Related MCP server: GraphHub

Быстрый старт

Предварительные требования: uv, git, ripgrep (рекомендуется)

Используя бэкенд relace (по умолчанию): получите API-ключ в панели управления Relace, затем добавьте его в свой 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"

Конфигурация

Переменная

Обязательно

Описание

RELACE_API_KEY

✅*

API-ключ из панели управления Relace; требуется для провайдеров Relace и облачных инструментов

MCP_SEARCH_RETRIEVAL

❌

Установите 1 для регистрации инструмента agentic_retrieval

MCP_RETRIEVAL_BACKEND

❌

Бэкенд семантического поиска: relace (по умолчанию), codanna, chunkhound или none

MCP_RETRIEVAL_HINT_POLICY

❌

Политика подсказок поиска: prefer-stale (по умолчанию) или strict

MCP_BACKGROUND_INDEX_MONITOR

❌

Опциональный монитор периодического обновления локальных индексов; требует закрепленного MCP_BASE_DIR и локального бэкенда

MCP_BACKGROUND_INDEX_INTERVAL_SECONDS

❌

Интервал монитора локального индекса в секундах (по умолчанию: 300)

MCP_BACKGROUND_INDEX_INITIAL_DELAY_SECONDS

❌

Начальная задержка перед первой проверкой локального индекса в секундах (по умолчанию: 30)

MCP_SEARCH_TURN_STATUS_MODE

❌

Политика сообщений о статусе хода: always (по умолчанию), final-only или off

SEARCH_BASH_TOOLS

❌

Включить bash во время поиска: 1 (вкл, по умолчанию), 0 (выкл)

SEARCH_LSP_TOOLS

❌

Включить поиск с поддержкой LSP: 1 (вкл), 0 (выкл, по умолчанию)

MCP_BASE_DIR

❌

Переопределение корня проекта (автоматически определяется через MCP Roots → Git → хранилище рабочей области → CWD)

MCP_LOGGING

❌

Файловое логирование: off (по умолчанию), safe, full

MCP_DOTENV_PATH

❌

Путь к файлу .env для централизованной конфигурации

* Опционально, если оба условия верны: (1) APPLY_PROVIDER и SEARCH_PROVIDER не являются провайдерами Relace, и (2) MCP_RETRIEVAL_BACKEND имеет значение codanna, chunkhound или none.

Информацию об использовании .env, настройках кодировки, пользовательских LLM-провайдерах и многом другом см. в docs/advanced.md.

Инструменты

Всегда доступны: fast_apply, agentic_search. agentic_retrieval требует MCP_SEARCH_RETRIEVAL=1. Облачные инструменты доступны только при MCP_RETRIEVAL_BACKEND=relace. index_status доступен для relace, codanna и chunkhound, и скрыт, если MCP_RETRIEVAL_BACKEND=none.

Используйте встроенные механизмы обнаружения MCP: list_tools() для инструментов и list_resources() для ресурсов.

Подробные параметры см. в docs/tools.md.

Поддержка языков

Инструменты LSP используют внешние языковые серверы, установленные в вашей системе.

Язык

Языковой сервер

Команда установки

Python

basedpyright

(в комплекте)

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

Панель управления

Терминальный интерфейс в реальном времени для мониторинга операций.

pip install relace-mcp[tools]
relogs

Подробное использование см. в docs/dashboard.md.

Бенчмарк

Оцените производительность agentic_search с помощью набора данных для локализации кода 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

Все артефакты бенчмарка записываются в benchmark/.data/.

Информацию о сеточном поиске, инструментах анализа и интерпретации метрик см. в docs/benchmark.md.

Поддержка платформ

Платформа

Статус

Примечания

Linux

✅ Полная поддержка

Основная платформа разработки

macOS

✅ Полная поддержка

Все функции доступны

Windows

⚠️ Частичная

Инструмент bash недоступен; используйте WSL для полной функциональности

Устранение неполадок

Ошибка или сообщение

Решение

RELACE_API_KEY is required ...

Установите RELACE_API_KEY при использовании провайдеров Relace или облачных инструментов

NEEDS_MORE_CONTEXT

Добавьте 1-3 уникальные опорные строки рядом с целевым блоком

INVALID_PATH

Убедитесь, что путь существует и находится внутри MCP_BASE_DIR или разрешенного дополнительного пути

FILE_TOO_LARGE

Файл превышает 10 МБ; разбейте изменения на меньшие файлы или правки

ENCODING_ERROR

Явно установите RELACE_DEFAULT_ENCODING для проектов не в UTF-8

AUTH_ERROR

Проверьте API-ключ и конфигурацию провайдера

RATE_LIMIT

Повторите попытку позже или уменьшите объем запросов

NETWORK_ERROR / TIMEOUT_ERROR

Проверьте сетевое подключение и повторите попытку

APPLY_NOOP

Добавьте более специфичные опорные строки или конкретные новые строки, чтобы слияние могло создать diff

MARKER_LEAKAGE

Убедитесь, что маркеры-заполнители используются только как заполнители, а не как ожидаемый буквальный вывод

TRUNCATION_DETECTED

Разбейте крупные правки с большим количеством удалений или используйте явные директивы удаления

BLAST_RADIUS_EXCEEDED

Разбейте изменение на более мелкие, локальные правки

Разработка

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

Лицензия

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