Ontology Atlas — MCP-сервер для Claude Code: обзор и запуск
Хранит онтологию кодовой базы в Markdown внутри репозитория. Позволяет ИИ-агентам читать карту зависимостей проекта и предлагать правки через MCP.
Открыть на GitHubЧто делает Ontology Atlas
Агенты меняют код быстрее, чем разработчики успевают фиксировать архитектуру. Atlas создаёт каталог atlas/ прямо в Git-репозитории. Каждый концепт описан отдельным файлом Markdown с неизменным uid, адресом slug и путём к коду path. Ассистент читает связи модулей, зависимости и нерешённые вопросы перед началом работы, а после завершения задачи предлагает обновить записи.
Любые обновления остаются черновиками до подтверждения человеком. Вы проверяете и принимаете правки через обычный Git diff. Сервер не додумывает связи: если доказательств в коде нет, статус остаётся неизвестным. Примеры из комментариев или цитат не считаются доказательством реализации.
Для macOS сервер встроен прямо в нативное приложение. На Linux MCP-сервер нужно запускать из исходного кода через интерфейс командной строки.
Какие задачи решает
- передать агенту контекст связей проекта перед правкой кода
- зафиксировать карту архитектуры в версионируемых файлах Markdown
- проверять и отклонять предложенные агентом описания через Git
- находить компоненты без подтверждённой реализации в коде
Примеры запросов агенту
- Сверься с папкой
atlas/и покажи, какие компоненты затронет рефакторинг авторизации. - Проверь онтологию репозитория на неразрешённые зависимости перед обновлением API.
- Подготовь описание нового сервиса платежей для каталога
atlas/.
Как установить Ontology Atlas
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Ontology Atlas
Как установить Ontology Atlas в Claude Code?
Скачайте приложение для macOS или запустите сервер из исходного кода на Linux. В окне программы перейдите в раздел Agents › MCP, нажмите Connect напротив вашего инструмента и перезапустите Claude Code.
Что делает MCP-сервер Ontology Atlas?
Он даёт ИИ-агенту доступ к каталогу atlas/ на диске. Модель изучает связи доменов и файлов перед редактированием кода, а затем предлагает правки документации.
Как сервер защищает от выдуманных архитектурных связей?
Система помечает неподтверждённые элементы как неизвестные, а не как безопасные. Примеры из кода или цитат не дают права объявлять новую возможность системы.
