Scubiee MCP
Локальный индекс кода для агентов: MCP-инструмент map ищет по смыслу и структуре, код не покидает машину
- 148 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Фоновый демон постоянно следит за репозиторием и хранит индекс кода на диске
- При настройке модель для эмбеддингов скачивается из внешнего источника
Установка
- Работает в
Ручная установка
uv tool install scubieeУстановка пакета из README, затем `scubiee setup` и `scubiee connect --claude-code` или `--all` для подбора клиента.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Фоновый демон постоянно следит за репозиторием и хранит индекс кода на диске
- При настройке модель для эмбеддингов скачивается из внешнего источника
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Scubiee строит на вашей машине индекс репозитория и отдает его агенту через MCP-сервер. Единственный инструмент `map` работает в двух режимах: `find` возвращает ранжированные места в коде, `focus` показывает нужный символ с окрестностями. Тот же поиск доступен в терминале командой `scubiee search`. Поиск объединяет граф кода (вызовы, импорты, определения), лексический BM25 и векторные эмбеддинги в FAISS. Разбор идет через Tree-sitter для Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, C#, Ruby и JSON. Фоновый демон сравнивает дерево Меркла и переиндексирует только изменившееся. Команда `scubiee connect` настраивает MCP в Cursor, Claude Code, Codex, Copilot, Kiro, Windsurf, Cline, Roo Code, Continue, Zed, OpenCode, Amp и других клиентах.
Для кого. Разработчикам больших репозиториев, у которых агент тратит токены на слепой grep, и командам, где код нельзя отправлять во внешние сервисы.
Подходит, если
- Агент долго ищет нужное место в большом репозитории и читает лишние файлы
- Код нельзя выгружать в облачный индекс, поэтому поиск нужен локальный
- Один индекс должен обслуживать сразу несколько клиентов: Cursor, Claude Code и Codex
- Нужен поиск по смыслу сверх точного совпадения строки
Не подходит, если
- Репозиторий небольшой, и обычного grep агенту хватает
- Язык проекта вне списка Tree-sitter: PHP, Kotlin и Swift среди заявленных не названы
- На машине мало места или нет Python 3.11, а скачивать модель в 270 МБ нельзя
Пример запроса к агенту
Найди в проекте место, где обрабатывается повторная отправка платежа, и покажи функцию с вызывающим кодомMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужен Python 3.11 или новее, авторы советуют ставить через `uv`. При настройке скачивается модель около 270 МБ, это единственный сетевой шаг. Ускорение выбирается автоматически: CUDA, DirectML, Apple MLX или процессор. Фоновый демон работает постоянно и держит индекс на диске. Последний коммит в репозитории датирован 25 октября 2026 года, а в дереве лежит много служебных резервных копий настроек. Индекс хранится на диске рядом с проектом, поэтому для крупных репозиториев нужно свободное место, а первая индексация занимает время. Качество поиска зависит от того, как агент формулирует запрос к инструменту.
Как отключить. Уберите запись scubiee из MCP-настроек агента (или отключите клиент командой из документации), остановите демон и удалите пакет через `uv tool uninstall scubiee`.
Частые вопросы
Уходит ли код из репозитория во внешние сервисы?
Нет, парсинг и эмбеддинги работают локально. Единственная сетевая операция при настройке — загрузка модели, около 270 МБ.
Какие клиенты умеет подключать scubiee?
Команда `scubiee connect` настраивает Cursor, Claude Code, Codex, Copilot, Kiro, Windsurf, Cline, Roo Code, Continue, Zed, OpenCode, Amp, Devin Desktop и Pi. Ключ `--all` подключает все найденные.
Что делает инструмент map?
Режим `find` возвращает ранжированный список мест в коде, режим `focus` показывает выбранный символ и контекст вокруг него.
Как индекс остается свежим?
Фоновый демон сравнивает дерево Меркла после правок и подтягиваний и переиндексирует только изменившиеся файлы.
Какие языки разбирает Scubiee?
Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, C#, Ruby и JSON через Tree-sitter.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный индекс кодовой базы для агентов: гибридный поиск, графы зависимостей и анализ последствий изменений
MCP-сервер индексирует локальный репозиторий через tree-sitter и дает агенту поиск по коду, список файлов и сводку по структуре файла
MCP-сервер, который индексирует код через tree-sitter и отдает агенту отдельные функции и классы вместо целых файлов
codesearch ищет по коду сразу в нескольких репозиториях гибридным поиском и работает офлайн, без GPU и Docker.
Локальный MCP-сервер строит индекс кода на SQLite и tree-sitter, и агент ищет символы, вызовы и смысл одним запросом
Быстрый семантический поиск по коду для агентов: возвращает нужные фрагменты вместо чтения файлов и тратит намного меньше токенов
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Scubiee (эта карточка) | нет | не нужна | 148 | |
| Claude Context | да | API-ключ | 12 689 | полностью локальный индекс, облачная база не нужна |
| Code Context Engine | нет | не нужна | 457 | граф кода, BM25 и FAISS в одном инструменте `map` с режимами find и focus |
Коротко о README
README подает Scubiee как локальный движок контекста кода для ИИ-агентов. Сначала идут обещания: локальность, MCP-сервер и живая синхронизация. Дальше список возможностей, быстрый старт из трех шагов, настройка клиентов и ссылки на документацию.