Ontology Atlas MCP
MCP-сервер ведет карту смысла кода в Markdown рядом с репозиторием: агент читает контекст перед задачей и вносит предложения.
- 149 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент получает запись в папку `atlas/` в репозитории, подключенный агент отправляет прочитанное своему провайдеру.
Установка
- Работает в
Ручная установка
docker run --rm -i --user "$(id -u):$(id -g)" -v /path/to/atlas:/vault ghcr.io/wlsdks/ontology-atlas-mcpВариант с контейнером из README MCP-пакета. Основной путь для macOS и Windows: приложение со встроенным сервером, страница загрузки ontologyatlas.com.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент получает запись в папку `atlas/` в репозитории, подключенный агент отправляет прочитанное своему провайдеру.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ontology Atlas хранит карту системы в папке `atlas/` репозитория: по файлу Markdown на понятие, с путями к коду, зависимостями и открытыми вопросами. MCP-сервер `ontology-atlas-mcp` читает и пишет эту папку прямо на диске, приложение при этом может быть закрыто. Агент перед задачей получает краткую справку `agent_brief`, а после задачи выдвигает обновления. Предложения остаются предложениями, пока человек не примет их в виде диффа Markdown. Карту показывают приложение для macOS и версия в браузере.
Для кого. Командам, где агенты быстро меняют код и никто не держит в голове общую картину: тимлидам и разработчикам крупных репозиториев.
Подходит, если
- Перед сложной задачей агенту нужна карта: что за часть кода, какие файлы и зависимости.
- После правки агент выдвигает обновить описание, а разработчик смотрит дифф в Git.
- Нужно понять, что могло задеть изменение, и отделить известное от неизвестного.
- Новый разработчик читает ту же карту, что и его агент.
Не подходит, если
- Репозиторий маленький, и всю структуру видно сразу.
- Нужны гарантии влияния на рантайм: линия на карте показывает объявленную связь, а не доказательство.
- Нет Node или контейнера и нельзя поставить приложение.
Пример запроса к агенту
Прочитай карту Atlas для задачи с платежами, покажи затронутые понятия и открытые вопросы, затем предложи обновление описания без записи.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
OATLAS_VAULTобязательная- Абсолютный путь к папке хранилища с Markdown-картой
Ограничения
Проект ранний: по замерам самого автора, ответы с Atlas пока не лучше, и работа идет медленнее. Каналов установки четыре, npm среди них нет: приложение, сборка из исходников на Node 24 и pnpm, файл `.mcpb` и контейнер. Приложение для Windows остается неподписанной бетой, на Linux берут браузер или исходники. Подключенный агент отправляет прочитанное своему провайдеру, журнал Atlas этого не покрывает.
Как отключить. Удалите запись `ontology-atlas` из `.mcp.json`, `.codex/config.toml` или `.cursor/mcp.json`. Папка `atlas/` остается обычным Markdown в репозитории: ее удаляют или оставляют как документацию.
Частые вопросы
Как подключить агента?
В приложении откройте «Agents, MCP» и нажмите Connect для своего инструмента. Кнопка записывает файл настроек: `.mcp.json` для Claude Code, `.codex/config.toml` для Codex, `.cursor/mcp.json` для Cursor.
Можно ли без приложения?
Да. Агент сам запускает MCP-сервер, он работает с папкой на диске без приложения. Запуск контейнером: `docker run --rm -i --user "$(id -u):$(id -g)" -v /path/to/atlas:/vault ghcr.io/wlsdks/ontology-atlas-mcp`.
Одобряет ли человек все записи агента?
Не обязательно. Документация оговаривает: подключение MCP не гарантирует ручное одобрение каждой записи: поведение зависит от настроек клиента.
Сколько у сервера инструментов?
По описанию пакета 40: 24 на чтение и 16 на запись.
Где лежит карта?
В папке `atlas/` репозитория: по файлу Markdown на понятие. Ее клонируют, ветвят и проверяют вместе с кодом.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальная карта репозитория для агента: CLI atlas и MCP ищут нужный код по назначению файлов, а не открывают все подряд.
Один MCP-сервер дает агенту карту кода на более 300 языков, историю git, общую память и поиск по документам с OCR.
MCP-сервер и CLI на Go: агент ведет в репозитории индекс кода и схемы базы, хранит его в Git и читает целиком перед каждой задачей
Задачи, документы, спецификации и решения проекта лежат файлами Markdown в репозитории, а агент читает их через CLI и MCP
MCP-сервер строит граф зависимостей репозитория и документацию, а инструмент codebase-qna отвечает агенту на вопросы о коде
Локальный граф структуры кода: строит карту репозитория через tree-sitter и отдает агенту по MCP только тот контекст, который относится к правке
Коротко о README
Карта кода лежит в Markdown рядом с кодом и ревьюится в Git. Агент читает ее по MCP, а человек видит ту же карту в приложении или в браузере.