RepoRelay — MCP-сервер для Claude Code: что делает и как установить
Ограничивает доступ ИИ ровно одной локальной папкой с кодом для чтения и поиска. Пригодится, когда нужно дать модели изучить проект без доступа к консоли и всей системе.
claude mcp add reporelay -- npx -y reporelay-mcpЧто делает RepoRelay
Сервер создаёт изолированный периметр вокруг выбранного каталога. Подключённая модель получает четыре инструмента для изучения кодовой базы: open_workspace, list_files, read_file и search_files. Она может читать файлы и искать инструкции, но лишена доступа к командной строке и вызовам Git. Выйти за пределы указанной папки агент технически не способен.
В обычном режиме добавляются три фиксированных метода передачи задач: write_next_task, write_review и update_handoff_state. Они сохраняют план и результаты проверки в файлы каталога .ai-handoff, чтобы другой локальный агент занялся реализацией. Произвольная запись в исходники заблокирована. Флаг --no-handoff-writes отключает даже эти три инструмента, оставляя строго режим чтения.
Для запуска требуется Node.js версии не ниже 22.19 и строго младше 27. Корень диска или домашнюю директорию пользователя сервер изолировать откажется.
Какие задачи решает
- изолировать доступ ИИ рамками одного репозитория
- запретить агенту выполнять команды в терминале и Git
- найти файлы инструкций через фильтр
instructionsOnly - сохранить план ревью в каталог
.ai-handoffбез изменения исходников
Примеры запросов агенту
- Найди в репозитории все файлы конфигурации через
list_files - Изучи структуру проекта и запиши план доработок через
write_next_task - Запусти поиск по слову auth в текущем каталоге через
search_files
Как установить RepoRelay
Командой платформы
claude mcp add reporelay -- npx -y reporelay-mcpКомандой платформы
codex mcp add reporelay -- npx -y reporelay-mcpФайл настроек
{
"mcpServers": {
"reporelay": {
"command": "npx",
"args": [
"-y",
"reporelay-mcp"
]
}
}
}Файл настроек
{
"servers": {
"reporelay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"reporelay-mcp"
]
}
}
}Командой платформы
gemini mcp add reporelay npx -y reporelay-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о RepoRelay
Как установить RepoRelay в Claude Code?
Выполните команду claude mcp add reporelay -- npx -y reporelay-mcp. Сервер сразу зарегистрируется в окружении Claude Code.
Что делает RepoRelay?
Он даёт ИИ доступ к одному конкретному локальному репозиторию только для чтения и поиска. Модель не может запускать команды терминала, менять произвольные файлы или выходить в другие каталоги диска.
Чем отличается режим чтения от режима с передачей задач?
В режиме чтения работают четыре инструмента для поиска и просмотра кода. В режиме handoff добавляются три метода для записи ревью и следующих задач в служебные файлы .ai-handoff.
