navigator — MCP-сервер для Claude Code: навигация по репозиторию
Ищет в репозитории релевантные файлы и диапазоны строк, объясняя их ранжирование. Пригодится, когда нужно найти доказательства по вопросу, не загружая весь проект в контекст.
claude mcp add navigator -- npx -y mentu-navigatorЧто делает navigator
navigator помогает агенту ориентироваться в репозитории и не изменяет его файлы. Команда locate ранжирует текстовые совпадения по BM25 и возвращает пути, диапазоны строк, фрагменты и причину ранжирования. Команда read-range читает выбранный участок с привязкой к заголовкам.
Также сервер умеет строить карту файлов, искать определения символов и оценивать возможные последствия изменений по Git-диапазону, тестам и контрактам. Для документации с frontmatter команда handles возвращает указатели и связи; перед использованием их нужно раскрыть отдельно. По умолчанию ранжирование проверяли на документации, а не на исходном коде, поэтому качество поиска по коду этим исследованием не подтверждено.
Для запуска нужен Node.js 20 или новее. Сервер доступен через npx; в Claude Code его добавляют командой из инструкции ниже. Это MCP-сервер только для чтения: репозиторий он не меняет.
Какие задачи решает
- найти файлы и строки с ответом на вопрос о проекте
- выбрать фрагмент документации для чтения без загрузки всего файла
- проследить определения и ссылки на символ
- оценить, какие тесты и контракты затронет Git-изменение
Примеры запросов агенту
- Найди, где в репозитории обрабатываются повторы запросов, и покажи диапазоны строк.
- Построй карту репозитория и найди определения символа
RetryPolicy. - Оцени, какие тесты и контракты могут затронуть изменения в текущем Git-диапазоне.
Как установить navigator
Командой платформы
claude mcp add navigator -- npx -y mentu-navigatorКомандой платформы
codex mcp add navigator -- npx -y mentu-navigatorФайл настроек
{
"mcpServers": {
"navigator": {
"command": "npx",
"args": [
"-y",
"mentu-navigator"
]
}
}
}Файл настроек
{
"servers": {
"navigator": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mentu-navigator"
]
}
}
}Командой платформы
gemini mcp add navigator npx -y mentu-navigatorПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о navigator
Как установить navigator в Claude Code?
Выполните claude mcp add navigator -- npx -y mentu-navigator. Для запуска нужен Node.js 20 или новее.
Что делает navigator?
Он находит в репозитории релевантные файлы и диапазоны строк, показывает причины ранжирования и позволяет прочитать выбранный участок. Файлы репозитория сервер не изменяет.
Какие требования у navigator?
Для запуска нужен Node.js 20 или новее. Команда locate использует BM25; ранжирование проверяли на документации, а не на исходном коде.
