Omnigraph MCP

Установка

Работает в

• Claude Code
• Cursor
• Codex
• SourceCraft
• Koda
• Coddy

Ручная установка

curl -fsSL https://raw.githubusercontent.com/ModernRelay/omnigraph/main/scripts/install.sh | bash

Что делает

Omnigraph — графовая база данных с ветвлением в стиле git. Данные лежат в открытом формате Lance на локальном диске или в S3-совместимом хранилище. Сервер `omnigraph-server` отдает базу агентам по Model Context Protocol по адресу `/mcp`: отдельный пакет не нужен. Работает Streamable HTTP, и каждый запрос несет свой токен в заголовке `Authorization: Bearer`. Claude Code и Cursor подключаются по URL и токену, а при настроенном доверии OIDC клиент входит через OAuth. По умолчанию агент получает инструменты чтения: `graphs`, `schema`, `queries`, `query` для сохраненных запросов, `snapshot`, `branches_list` и три вызова для истории коммитов. Инструмент `read` для произвольных запросов на языке GQ включается флагом `--mcp-allow-adhoc`, а инструменты записи `mutate`, `load`, `branches_create`, `branches_delete` и `branches_merge` флагом `--mcp-allow-writes`. Флаги лишь показывают инструменты, а права определяет политика Cedar на сервере: вызов выполняется под тем же действием политики, что и обычный HTTP-маршрут. Кроме MCP, в репозитории есть скилл для агента. Команда `omnigraph skill export ~/.claude/skills/omnigraph --force` записывает SKILL.md с инструкциями по схемам `.pg`, запросам `.gq`, ветвям и политикам, и его версия совпадает с установленной командной строкой. Те же справочные материалы сервер отдает ресурсами `omnigraph://best-practices/`. Схемы и развертывание кластера через MCP не меняются: их ведет оператор командами `omnigraph cluster plan` и `omnigraph cluster apply`.

Для кого. Для разработчиков и команд, которые строят память или общую модель знаний для нескольких агентов и готовы поднять собственный сервер и хранилище.

Пример запроса к агенту

Подключись к моему серверу Omnigraph, покажи схему графа knowledge и найди все источники, которые подтверждают утверждение lower-latency

MCP

Транспорт

http

Авторизация

API-ключ

Ограничения

• Запрос к `/mcp` не должен превышать 64 КиБ, полный результат инструмента занимает до 1 МиБ, чтение ждет 30 секунд, одновременно выполняется до 16 вызовов. Большие загрузки идут через `POST /load/ndjson`.
• Сервер отвечает 403, если имя хоста не разрешено. За балансировщиком без OIDC его нужно добавить флагом `--mcp-allowed-host`. С обычным статическим токеном инструмент `graphs` тоже отвечает 403, пока политика кластера не разрешит действие `graph_list`.
• Запись, которая шла дольше 30 секунд или чей ответ потерян, возвращает `outcome_unknown`. Повторять ее надо с параметром `if_graph_commit`, иначе изменение может примениться дважды.
• Готовые архивы релиза 0.13.0 есть для Linux x86_64 и arm64, macOS на arm64 и Windows x86_64. Скилл описывает версию 0.14.0 и контракт HTTP 0.13: командную строку, сервер и интеграции обновляйте вместе.
• Лицензия MIT. Главная страница репозитория еще называет серверный пакет `@modernrelay/omnigraph-mcp`, а документация MCP говорит, что встроенный `/mcp` заменил его.

Как отключить. Удалите сервер из настроек MCP-клиента и остановите процесс `omnigraph-server`. Скилл уберите вместе с папкой `~/.claude/skills/omnigraph`, а бинарники из `~/.local/bin`. Данные графа остаются в вашем хранилище и удаляются отдельно.

Коротко о README

Главная страница описывает возможности базы в таблице: типизированная онтология, поиск по графу, векторам и тексту в одном запросе, ветвление, кластер как код, политики Cedar и хранение в объектном хранилище. Дальше идут сценарии применения, установка, раздел о настройке силами ИИ-агента, развертывание в три шага, примеры запросов и ветвей, клиенты и сборка. В репозитории есть документация для пользователей, предложения по изменениям, руководство по управлению проектом, тесты и отдельный репозиторий с готовыми графами-примерами.