Probe MCP
Поиск по коду с разбором AST: агент получает целые функции и классы вместо обрывков строк, без индексации и без запросов к модели
- 740 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Читает файлы выбранной директории и передает найденные фрагменты в контекст модели
- В режиме `agent` с флагами `--allow-edit` и `--enable-bash` меняет код и запускает команды оболочки
- Установочные скрипты `install.sh` и `install.ps1` скачиваются из ветки main и сразу выполняются
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/probeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает файлы выбранной директории и передает найденные фрагменты в контекст модели
- В режиме `agent` с флагами `--allow-edit` и `--enable-bash` меняет код и запускает команды оболочки
- Установочные скрипты `install.sh` и `install.ps1` скачиваются из ветки main и сразу выполняются
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Probe ищет по структуре кода. Он сочетает скорость ripgrep с разбором tree-sitter и возвращает функцию, класс или структуру целиком. Запросы пишутся в синтаксисе Elasticsearch: `AND`, `OR`, `NOT`, фразы в кавычках и фильтры вроде `ext:rs` или `lang:python`. Результаты ранжирует BM25, TF-IDF или их смесь, а бюджет ответа задает флаг `--max-tokens`. Предварительная индексация и модель эмбеддингов не нужны, поиск идет локально. К агенту Probe подключается двумя способами. Режим `mcp` отдает четыре инструмента: `search`, `query` для поиска по шаблону AST, `extract` для вырезки блока по номеру строки или имени символа и `symbols` со списком символов файла. Режим `agent --mcp` ставит перед ними встроенного агента, который сам строит запросы и рассуждает над найденным. Он берет авторизацию Claude Code или Codex либо ключ Anthropic, OpenAI или Google. То же доступно в терминале: `probe search`, `probe extract`, `probe query` и разовые вопросы командой `probe agent`. Флаг `--allow-edit` включает правку кода агентом, `--enable-bash` разрешает ему команды оболочки.
Для кого. Для разработчиков, у которых Claude Code, Cursor или Codex тратят много шагов на grep по большому репозиторию и режут функции посреди тела.
Подходит, если
- Репозиторий на сотни тысяч строк, и агенту нужно найти всю логику авторизации одним запросом `authentication AND login`
- Нужен код функции по имени символа или по строке: `probe extract src/main.rs:42`
- Требуется структурный поиск по шаблону, например все функции Rust с типом результата `Result`, через `probe query`
- Нужен локальный поиск без базы векторов и без сервиса эмбеддингов, который каждый раз возвращает один и тот же ответ
- Надо разобрать незнакомую кодовую базу или сделать ревью, не давая агенту править файлы
Не подходит, если
- Вам нужен поиск по смыслу, когда в коде нет ни одного слова из запроса: Probe сопоставляет слова, а перефразировать запрос приходится модели
- Язык проекта вне списка поддерживаемых: Rust, JavaScript, TypeScript, Python, Go, C, C++, Java, Ruby, PHP, Swift, Solidity, Crystal, C#, Bash, QML и разметка
- Репозиторий маленький, и обычного `grep` с чтением файлов агенту хватает
- Агент нужен для правок в нескольких файлах с отменой: встроенный агент Probe лишь читает, пока вы не включите `--allow-edit`
Пример запроса к агенту
Найди через Probe всю логику авторизации в этом репозитории и покажи функции целикомMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
ANTHROPIC_API_KEYсекрет- Ключ Anthropic для режима `agent`. Не нужен, если агент берет авторизацию Claude Code.
OPENAI_API_KEYсекрет- Ключ OpenAI для режима `agent`.
GOOGLE_API_KEYсекрет- Ключ Google для режима `agent`.
FORCE_PROVIDER- Принудительный выбор провайдера, например `anthropic`.
Ограничения
- Поиск лексический. Синонимы агент должен подставить сам, перечислив их через `OR`.
- Для режима `agent` нужен доступ к модели: авторизация Claude Code или Codex либо ключ в `ANTHROPIC_API_KEY`, `OPENAI_API_KEY` или `GOOGLE_API_KEY`. Режим `mcp` модель не вызывает.
- Режим `agent` с внешней моделью отправляет найденный код ее провайдеру.
- Установка через `npm install -g @probelabs/probe` скачивает бинарный файл. Сценарии `install.sh` и `install.ps1` запускают скрипт из репозитория, прочитайте их до запуска.
Как отключить. Удалите блок `probe` из конфигурации MCP агента и перезапустите его. Глобальную установку снимает `npm uninstall -g @probelabs/probe`. Запуск через `npx` ничего не оставляет, кроме кэша npm.
Частые вопросы
Как подключить Probe к Claude Code?
Добавьте в конфигурацию MCP команду `npx` с аргументами `-y @probelabs/probe@latest mcp`. Это даст агенту инструменты `search`, `query`, `extract` и `symbols`. Если нужен встроенный агент Probe, замените `mcp` на `agent --mcp`, и он использует авторизацию Claude Code.
Чем Probe отличается от grep и ripgrep?
Probe разбирает код деревом tree-sitter и отдает блок целиком, а `grep` возвращает строки. Скорость сопоставима, потому что внутри работает ripgrep. Дополнительно есть ранжирование BM25 и бюджет `--max-tokens`.
Нужен ли Probe индекс или эмбеддинги?
Нет. Probe работает без индексации и без модели эмбеддингов, результат появляется сразу и воспроизводим: тот же запрос дает тот же ответ. Код не покидает машину, пока вы не включили встроенный агент с внешней моделью.
Как получить код функции по имени?
Выполните `probe extract <файл>#<символ>` или укажите строку: `probe extract src/main.rs:42`. Через MCP то же делает инструмент `extract`. Список символов файла выводит `symbols`.
Как запретить агенту Probe менять файлы?
Ничего не включайте: правка кода выключена, пока нет флага `--allow-edit`, а команды оболочки закрыты без `--enable-bash`. Режим `mcp` с четырьмя инструментами поиска файлы вообще не меняет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыБыстрый семантический поиск по коду для агентов: возвращает нужные фрагменты вместо чтения файлов и тратит намного меньше токенов
Context Engine — поиск по коду и память для агента
Context Engine
Скилл учит агента сначала обращаться к индексу кода и графу символов Context Engine и только потом читать файлы напрямую
Поиск по исходникам ранжирует совпадения с учетом структуры кода и дает агенту нужные фрагменты без отдельного индекса.
Локальный поиск и MCP-сервер для агентов: один бинарник на Rust индексирует код, документы и логи
Локальный индекс кода для агентов: MCP-инструмент map ищет по смыслу и структуре, код не покидает машину
codesearch ищет по коду сразу в нескольких репозиториях гибридным поиском и работает офлайн, без GPU и Docker.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Probe (эта карточка) | нет | не нужна | 740 | |
| code-index-mcp | нет | не нужна | 162 | строит индекс проекта заранее, а Probe ищет без индексации |
| ast-grep | нет | 16 567 | CLI для структурных правок по шаблону, у Probe упор на поиск и выдачу контекста агенту | |
| Serena | нет | не нужна | 31 335 | работает через языковые серверы и умеет править символы, Probe только читает код |
Коротко о README
README открывается сравнением Probe с grep и инструментами на эмбеддингах, затем показывает четыре режима запуска: агент через MCP, чистые инструменты MCP, CLI-агент и прямые команды. Дальше идут таблица возможностей, раздел об SDK для Node.js и о скриптах LLM Script, способы установки, список языков и переменные окружения.