pitlane-mcp
MCP-сервер индексирует код через tree-sitter: агент читает отдельные символы вместо файлов, находит пути, оценивает влияние правок
- 76 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Читает код проекта и хранит индекс на диске, но не пишет в исходные файлы
Установка
- Работает в
Ручная установка
brew tap eresende/pitlane-mcp && brew install pitlane-mcpДругие способы: `cargo binstall pitlane-mcp`, `cargo install pitlane-mcp` и бинарные файлы релизов.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Читает код проекта и хранит индекс на диске, но не пишет в исходные файлы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
pitlane-mcp один раз индексирует кодовую базу через tree-sitter, и агент извлекает только нужные символы вместо выгрузки целых файлов в контекст. Сервер разбирает Rust, Python, JavaScript, TypeScript, Svelte, C, C++, Go, Java, C#, Ruby, Swift, Objective-C, PHP, Zig, Kotlin, Lua, Solidity и Bash, а также заголовки Markdown и ключи JSON, YAML и TOML. Поиск идет по BM25, необязательно с семантическим слоем. По умолчанию агенту открыты одиннадцать инструментов. `ensure_project_ready` строит индекс при старте, `investigate` отвечает на широкие вопросы о подсистеме, `locate_code` находит место без исходника, `read_code_unit` читает нужную единицу. `trace_path` прослеживает путь от источника к приемнику, `analyze_impact` оценивает влияние перед правкой, `analyze_changes` разбирает git diff. `search_knowledge` и `read_knowledge_document` ищут и открывают документы Markdown с метаданными OKF. Остальные примитивы появляются при `PITLANE_MCP_TOOL_TIER=all`. Индекс пополняется инкрементально и хранится на диске, внешняя служба не нужна. Тот же функционал отдает команда `pitlane`, а к MCP добавлен скилл `pitlane-navigation`.
Для кого. Разработчикам, чьи агенты читают файлы целиком и упираются в окно контекста на больших кодовых базах.
Подходит, если
- Агент отвечает на вопрос о подсистеме, а читать надо только нужные функции
- Перед рефакторингом нужна оценка влияния: какие места затронет изменение
- Нужно проследить путь от конфигурации к эффекту через вызовы
- Репозиторий смешанный, с Rust, TypeScript и Python, и индекс нужен по всем языкам
- Документацию Markdown хочется искать по заголовкам и доверию к источнику
Не подходит, если
- Репозиторий маленький и умещается в контекст целиком
- Язык кода вне списка поддерживаемых
- Агенту нужно писать или править файлы: сервер дает только чтение и навигацию
Пример запроса к агенту
Проиндексируй проект и объясни, как запрос проходит от обработчика до базы, не читая файлы целиком.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
PITLANE_EMBED_URL- Адрес сервера эмбеддингов для семантического поиска
PITLANE_EMBED_MODEL- Модель эмбеддингов для семантического поиска
Ограничения
Проект в режиме поддержки, крупные функции не планируются. Для семантического поиска нужен доступный сервер эмбеддингов: задают `PITLANE_EMBED_URL` и `PITLANE_EMBED_MODEL`, функция помечена как экспериментальная и заметно удлиняет индексацию больших баз. Без этих переменных сетевых вызовов нет. Скрытые примитивы включаются через `PITLANE_MCP_TOOL_TIER=all`. Индекс хранится на диске рядом с проектом, при смене структуры репозитория его стоит перестроить.
Как отключить. Уберите сервер командой `claude mcp remove pitlane-mcp`, удалите бинарные файлы `pitlane-mcp` и `pitlane` (`brew uninstall pitlane-mcp` или `cargo uninstall pitlane-mcp`) и файлы индекса.
Частые вопросы
Как подключить pitlane-mcp к Claude Code?
Командой `claude mcp add pitlane-mcp -- pitlane-mcp`. Для Cursor и Kiro конфигурацию кладут в `.cursor/mcp.json` или `.kiro/settings/mcp.json`.
Какие инструменты видит агент по умолчанию?
Одиннадцать: `ensure_project_ready`, `investigate`, `locate_code`, `read_code_unit`, `trace_path`, `analyze_impact`, `analyze_changes`, `get_index_stats`, `search_content`, `search_knowledge` и `read_knowledge_document`.
Нужен ли внешний сервис?
Нет, сервер работает полностью локально. Семантический поиск включается отдельно и использует ваш сервер эмбеддингов, например Ollama.
Как включить семантический поиск?
Задайте `PITLANE_EMBED_URL` и `PITLANE_EMBED_MODEL`, например `http://localhost:11434/api/embed` и `nomic-embed-text`, и переиндексируйте проект.
Есть ли CLI без MCP?
Да. Бинарный файл `pitlane` дает ту же индексацию и поиск из терминала, например `pitlane search /your/project "..." --mode semantic`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер индексирует локальный репозиторий через tree-sitter и дает агенту поиск по коду, список файлов и сводку по структуре файла
Локальный MCP-сервер с графом вызовов и поиском символов: агент видит структуру кода и последствия правки заранее.
Локальный граф знаний о коде с историей версий: MCP-сервер отвечает агенту, кто вызывает функцию и что сломается от правки
MCP-сервер и CLI для исследования кода: поиск и разбор по вашему проекту и по всему GitHub с экономией токенов
MCP-сервер, который индексирует код через tree-sitter и отдает агенту отдельные функции и классы вместо целых файлов
Rust-бинарник для агентов и терминала: через tree-sitter находит определение символа, его вызовы и зависимости файла
Коротко о README
Описаны назначение, установка через релизы, Homebrew и cargo, быстрый старт для Claude Code, OpenCode, VS Code и Cursor, порядок работы с инструментами и CLI.