basemind MCP
Один MCP-сервер дает агенту карту кода на более 300 языков, историю git, общую память и поиск по документам с OCR.
- 117 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Домены `shell` и `web` запускают терминальные сессии и ходят в сеть по команде агента.
- Индекс, память и тексты документов остаются на диске, а `basemind init` дописывает блок правил в файлы проекта.
Установка
- Работает в
Ручная установка
/plugin marketplace add Goldziher/basemind
/plugin install basemind@basemindРекомендуемый путь: плагин сам скачивает программу при первом запуске.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Домены `shell` и `web` запускают терминальные сессии и ходят в сеть по команде агента.
- Индекс, память и тексты документов остаются на диске, а `basemind init` дописывает блок правил в файлы проекта.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
basemind индексирует репозиторий и отвечает агенту путями файлов, номерами строк и сигнатурами вместо целых файлов. Инструмент `code` показывает структуру файла, ищет определения, места вызова и реализации интерфейсов. `graph` строит граф вызовов и архитектурную карту, а `git` отвечает, кто и когда менял функцию или строку. Сервер состоит из девяти доменов: `code`, `graph`, `git`, `memory`, `web`, `agents`, `shell`, `admin` и `workspace`. Среди них `memory` хранит общую память репозитория и ищет по PDF, файлам Office, HTML и изображениям с OCR, `agents` связывает нескольких агентов ветками переписки, `shell` запускает фоновые терминальные сессии, а `web` собирает страницы. Индекс лежит в глобальном кеше на машине пользователя.
Для кого. Разработчикам, которые гоняют агентов по большим репозиториям и хотят тратить меньше токенов на чтение файлов.
Подходит, если
- Агент в Claude Code выжигает контекст на `grep` и чтение файлов в монорепозитории.
- Перед рефакторингом надо увидеть все места вызова функции и все реализации интерфейса.
- Выясняют, кто последним менял строку и когда изменилось тело функции.
- Несколько агентов работают в одном репозитории и обмениваются сообщениями по веткам.
- PDF и документы проекта ищут по смыслу вместе с кодом.
Не подходит, если
- Репозиторий маленький, и агенту хватает прямого чтения файлов.
- На компьютере нельзя скачать модели для документов и поиска при первом запуске.
- Агенту не стоит давать фоновые терминальные сессии и сбор веб-страниц.
Пример запроса к агенту
Покажи структуру `src/server.ts`, найди все места вызова `processFile` и скажи, кто последним менял эту функцию.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
BASEMIND_BIN- Путь к локальной сборке: плагин запускает ее вместо скачанного релиза.
Ограничения
Плагин при первом запуске скачивает программу basemind, а сборки с полным набором функций при первом запуске подтягивают модели для документов и поиска. Команда `cargo install basemind --locked` собирает только карту кода и git, для `basemind serve` нужен флаг `--features comms`. Для ручного подключения MCP и для Pi программу ставят отдельно. Домены `shell` и `web` расширяют права агента, поэтому автоподтверждение включают только для безопасных чтений. Команда `basemind init` дописывает блок правил в `CLAUDE.local.md` или другой файл проекта.
Как отключить. Удалите плагин через менеджер плагинов агента или запись basemind из конфигурации MCP. Блок правил от `basemind init` убирают вручную: он ограничен маркерами `BEGIN basemind` и `END basemind`. Индекс хранится в `~/.local/share/basemind/` на Linux.
Частые вопросы
Как подключить basemind к Claude Code?
В сессии выполните `/plugin marketplace add Goldziher/basemind`, затем `/plugin install basemind@basemind`. После перезапуска один раз запустите `/bm-statusline`, чтобы включить статусную строку. Без плагина сервер подключает `claude mcp add basemind -- basemind serve`.
Чем плагин отличается от ручного подключения MCP?
Плагин сам скачивает подходящую версию программы. При ручном подключении программу ставят через Homebrew, npm, pip или cargo и указывают `basemind serve` как команду запуска.
Что делает `basemind init`?
Создает `basemind.toml`, спрашивает, какие возможности включить, и добавляет блок правил «предпочитай basemind вместо grep». По умолчанию блок попадает в `CLAUDE.local.md`, которого нет в git. Флаг `--print` показывает изменения без записи.
Работает ли basemind в Cursor и Codex?
Да. В Cursor добавьте блок `mcpServers` в `.cursor/mcp.json`, в Codex выполните `codex mcp add basemind -- basemind serve`. В README есть также Windsurf, Gemini CLI, Copilot CLI, Cline и OpenCode.
Где хранится индекс?
В едином глобальном кеше на машине. На Linux это `~/.local/share/basemind/`. Он общий для всех рабочих копий репозитория на этом компьютере.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который строит граф кода: функции, классы, вызовы и маршруты, и отвечает на структурные запросы агента локально
Локальный граф знаний о коде с историей версий: MCP-сервер отвечает агенту, кто вызывает функцию и что сломается от правки
GraphMind
graphmind
Локальный MCP-сервер строит граф кода и хранит память о решениях проекта, так что агент не перечитывает репозиторий каждую сессию
MCP-сервер, который индексирует код через tree-sitter и отдает агенту отдельные функции и классы вместо целых файлов
MCP-сервер постоянной памяти для кодовых агентов: граф понятий, архитектуры и решений проекта, который сохраняется между сессиями
Локальный индекс кодовой базы для агентов: гибридный поиск, графы зависимостей и анализ последствий изменений
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| basemind (эта карточка) | нет | не нужна | 117 | |
| codebase-memory-mcp | нет | не нужна | 48 228 | codebase-memory-mcp строит граф кода и отвечает на структурные запросы; basemind добавляет историю git, документы с OCR, общую память и переписку агентов |
| Serena | нет | не нужна | 31 148 | Serena дает агенту возможности IDE через LSP или JetBrains; basemind индексирует код деревьями tree-sitter и работает без языковых серверов |
Коротко о README
Репозиторий содержит плагин для одиннадцати профилей агентов: десять публичных скиллов и шесть команд. Отдельно лежат адаптер терминала OpenCode и расширение Pi. Программа написана на Rust и поставляется через Homebrew, npm, pip, cargo и бинарные релизы.