GraphMind MCP
graphmind
Локальный MCP-сервер строит граф кода и хранит память о решениях проекта, так что агент не перечитывает репозиторий каждую сессию
- 217 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Команда setup правит ~/.claude/settings.json, ~/.claude/CLAUDE.md, профиль оболочки и git-хуки проектов
- Читает исходный код всех зарегистрированных репозиториев и хранит его граф и память на диске
- Ключи OpenAI или Voyage AI для векторов лежат в ~/.graphmind/config.json, а код уходит к провайдеру, если его включить
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/aouicher/graphmind/main/scripts/install.sh | bashСкрипт для macOS и Linux, прочтите его перед запуском. Затем один раз graphmind setup.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Команда setup правит ~/.claude/settings.json, ~/.claude/CLAUDE.md, профиль оболочки и git-хуки проектов
- Читает исходный код всех зарегистрированных репозиториев и хранит его граф и память на диске
- Ключи OpenAI или Voyage AI для векторов лежат в ~/.graphmind/config.json, а код уходит к провайдеру, если его включить
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
GraphMind индексирует репозиторий в граф на уровне функций: разбор идет через tree-sitter для более чем 30 языков. Агент получает по MCP 27 инструментов: поиск символа, вызывающие и вызываемые функции, карту зависимостей файлов, радиус влияния изменения, циклические зависимости, мертвый код и экспорт графа в Mermaid или DOT. Ответы сжаты до одной строки на символ, исходный код возвращается только по запросу. Поверх графа работают семантические векторы и память. Векторы строит локальная модель ONNX, а при желании OpenAI или Voyage AI, у новых установок они выключены. Память хранит решения, шаблоны и соглашения проекта в файлах JSONL в ~/.graphmind/memory и подставляет подходящие записи в контекст на каждом запросе. Связи между зарегистрированными репозиториями показывают общие зависимости. Команда graphmind setup один раз настраивает Claude Code (хуки, скилл /gm и 19 вложенных скиллов), Claude Desktop, OpenCode, Cursor и VS Code. Команда graphmind init регистрирует проект, ставит git-хуки пересборки и строит граф. Сервер работает по stdio и запускается командой graphmind mcp. Для macOS есть настольное приложение, на Linux и Windows работает CLI.
Для кого. Разработчикам с большими или несколькими репозиториями, которые работают с Claude Code, Cursor или другим MCP-агентом и устали от повторного чтения кода.
Подходит, если
- Перед правкой нужно знать, что сломает смена сигнатуры функции: gm_fn_impact покажет радиус влияния
- Агент тратит контекст на grep по большому репозиторию, а ответ нужен в нескольких строках
- Решения, принятые на прошлой неделе, должны помнить все следующие сессии агента
- Несколько репозиториев делят библиотеки, и нужен поиск символа по всем сразу через gm_cross_query
- Перед чисткой кода требуется список функций без входящих вызовов и циклических зависимостей
Не подходит, если
- Репозиторий маленький: агенту хватает обычного поиска по файлам
- Язык проекта не входит в список поддерживаемых tree-sitter
- Нельзя менять ~/.claude/settings.json, ~/.claude/CLAUDE.md и профиль оболочки: graphmind setup правит их
- Нужна работа в команде через облако: синхронизация доступна на платных тарифах Pro и Team
Пример запроса к агенту
Построй граф этого репозитория через GraphMind и покажи, что сломается, если я изменю сигнатуру функции validate_tokenMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- graphmind setup правит несколько файлов: профиль оболочки, ~/.claude/settings.json, ~/.claude/CLAUDE.md, конфигурацию Cursor и OpenCode, а также git-хуки зарегистрированных проектов. Перед изменением профиля и существующего хука делается резервная копия.
- Настольное приложение выпускается только для macOS, на Linux и Windows доступен CLI.
- Векторный поиск у новых установок выключен: нужна локальная модель ONNX или ключ OpenAI либо Voyage AI.
- Инструменты команды (gm_team_memories, gm_team_who_knows) входят в тарифы Pro и Team. Цифра экономии токенов в README относится к одному сравнению на коде около 100 тысяч строк.
Как отключить. Команда graphmind uninstall all снимает все интеграции, добавленные командами setup и init, а с флагом --purge удаляет и данные в ~/.graphmind. Отдельно работают graphmind uninstall hook-claude и graphmind uninstall hook-git. Флаг --yes пропускает подтверждения.
Частые вопросы
Чем GraphMind отличается от grep и обычного поиска агента?
Grep возвращает все совпадения строками, а GraphMind отдает ранжированные символы со связями и сигнатурами. По сравнению автора, на коде около 100 тысяч строк это меньше 300 токенов против более чем 1,5 миллиона у grep.
Как подключить GraphMind к Claude Code?
Выполните graphmind setup один раз и graphmind init в папке проекта. Запись MCP появится в ~/.claude.json для этого репозитория, а в сессии заработают инструменты gm_query, gm_search, gm_impact и остальные.
Куда GraphMind отправляет код?
По умолчанию никуда: граф и память лежат на вашей машине, открытых портов нет, телеметрии нет. Запросы к OpenAI или Voyage AI идут только если вы включили такого провайдера для векторов.
Как работает память GraphMind?
Хук находит записи, подходящие к запросу, и подставляет их в контекст. Агент сам сохраняет решения и соглашения проекта. Запись через gm_memory_add требует подтверждения. Приватные записи с is_shared: false не покидают машину.
Как удалить GraphMind целиком?
Команда graphmind uninstall all отменяет setup и init, а флаг --purge вдобавок стирает каталог ~/.graphmind.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыГраф кода и память проекта в одной программе на Rust: агент получает выдержки из файлов со ссылкой на строки
Один MCP-сервер дает агенту карту кода на более 300 языков, историю git, общую память и поиск по документам с OCR.
Локальный граф знаний о коде с историей версий: MCP-сервер отвечает агенту, кто вызывает функцию и что сломается от правки
Deep Graph MCP — граф кода репозитория для агента
Deep Graph MCP
MCP-сервер дает агенту граф кода репозитория: поиск функций по смыслу, связи символов и список мест, которые заденет правка
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
MCP-сервер и CLI, которые строят граф знаний по монорепозиторию и дают агенту запрашивать, понимать и править многоязычный код
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| GraphMind (эта карточка) | нет | не нужна | 217 | |
| codebase-memory-mcp | нет | не нужна | 48 228 | тоже граф кода с локальными запросами, но без слоя постоянной памяти о решениях проекта |
| CodeGraph | нет | не нужна | 76 962 | локальный граф кода с точками входа и радиусом влияния, без памяти и связей между репозиториями |
| Serena | нет | не нужна | 31 148 | дает агенту возможности IDE через LSP, а не граф с памятью |
Коротко о README
Страница объясняет четыре слоя: структурный граф, семантические векторы, постоянную память и связи между проектами. Затем идут установка через приложение, скрипт или Homebrew, подробности setup и init и ручная настройка для Claude Code, Claude Desktop, Cursor и VS Code. Завершают таблица из 27 инструментов, параметры безопасности и список языков.