iso-topology MCP
iso-topology превращает текст об архитектуре в изометрическую SVG-схему, которую агент проверяет и правит по контракту
- 74 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Пишет SVG, HTML и PNG в указанную папку и запускает локальный сервер предпросмотра по команде `isotopo serve`
Установка
- Работает в
Ручная установка
claude mcp add isotopo -- isotopo-mcpСначала go install github.com/MarkovWangRR/iso-topology/cmd/isotopo-mcp@latest.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Пишет SVG, HTML и PNG в указанную папку и запускает локальный сервер предпросмотра по команде `isotopo serve`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
iso-topology рисует схемы архитектуры как код: из текста на YAML или графа D2 получается изометрическая SVG-диаграмма 2.5D, которую можно хранить в Git и сравнивать в диффах. Положение элементов задают отношения `layout` и `place`, координат в пикселях нет. Один статический бинарник работает офлайн, а вывод побайтово детерминирован: тот же ввод дает тот же SVG. Агент работает по циклу. `isotopo capabilities` отдает машиночитаемый перечень DSL, `isotopo validate` проверяет схему и подсказывает исправления, `isotopo evaluate` считает пересечения, перекрытия и оценку композиции, `isotopo repair --compose --write` чинит перекрытия, контраст и выравнивание. Затем `isotopo render` рисует результат, `isotopo snapshot` делает PNG для визуальной самопроверки, а `isotopo preview` показывает один узел или связь. К Claude Code сервер подключают командой `claude mcp add isotopo -- isotopo-mcp`. Есть и вариант скилла: скрипт `scripts/install-skill.sh` из клона репозитория. Библиотека содержит больше 200 значков, включая логотипы брендов.
Для кого. Инженерам и техписателям, которым нужны аккуратные схемы инфраструктуры в репозитории, обновляемые агентом вместе с кодом.
Подходит, если
- Нужна схема архитектуры в темном стиле для документации, и ее надо получить фразой «нарисуй ClickHouse-аналитику в реальном времени»
- Схему приходится менять каждый раз, когда меняется инфраструктура, и ее лучше хранить текстом рядом с кодом
- Агент должен сам проверить схему на пересечения и перекрытия, прежде чем показывать ее вам
- Mermaid и D2 дают плоские блок-схемы, а нужен выразительный изометрический стиль
Не подходит, если
- Обычной плоской блок-схемы достаточно: хватит Mermaid или D2
- Требуется диаграмма последовательности или UML: инструмент рисует только архитектурные схемы
- Схему должен править человек мышью в Figma: здесь основной путь текст и агент
Пример запроса к агенту
Нарисуй изометрическую схему архитектуры нашего сервиса на LangGraph в темном стиле, проверь ее через validate и evaluate и сохрани SVG в docs/MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- Ставится через Go: `go install` на бинарники `isotopo` и `isotopo-mcp`, нужен установленный Go.
- В README команды установки ссылаются на модуль `github.com/MarkovWangRR/iso-topology`, владелец модуля в пути отличается от владельца репозитория NexusFox88: проверьте путь перед запуском.
- Результат изометрический 2.5D, плоские и пространственные схемы другого вида инструмент не рисует.
- Для Claude Code описаны MCP-сервер и скилл, для других клиентов есть `llms.txt` и шаблон промпта.
Как отключить. Уберите сервер командой `claude mcp remove isotopo` и удалите бинарники isotopo и isotopo-mcp из каталога `$GOPATH/bin`. Скилл снимается удалением своей папки в `~/.claude/skills`. Созданные схемы остаются обычными файлами в проекте.
Частые вопросы
Как подключить iso-topology к Claude Code?
Поставьте бинарники `go install github.com/MarkovWangRR/iso-topology/cmd/isotopo-mcp@latest` и выполните `claude mcp add isotopo -- isotopo-mcp`. Вместо MCP можно установить скилл скриптом `scripts/install-skill.sh`.
Чем iso-topology отличается от Mermaid?
Mermaid и D2 рисуют плоские блок-схемы, iso-topology выдает изометрические 2.5D-схемы с градиентами, свечением и логотипами брендов. DSL проверяется контрактом, поэтому агент сам исправляет ошибки.
Нужен ли браузер или шрифты для рендера?
Нет. Один статический бинарник без зависимостей рендерит схему офлайн за миллисекунды, ни браузер, ни шрифты не нужны.
Можно ли начать с обычного графа D2?
Да. Запишите `user -> api -> db` в файл `scene.d2` и выполните `isotopo render scene.d2 ./out`, получится `out/topology.svg`. Команда `isotopo serve scene.d2` открывает редактор на `localhost:8731`.
Что проверяют validate и evaluate?
`isotopo validate` проверяет схему по JSON-схеме с подсказками исправлений, а `isotopo evaluate` считает пересечения, перекрытия и композицию. Ответ структурирован, поэтому агент правит схему без участия человека.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыХолст для диаграмм, на котором Claude Code и Codex рисуют по MCP: схемы из Mermaid, D2 и Structurizr, карта репозитория, экспорт в SVG и PDF
Официальный MCP-сервер draw.io: агент строит диаграммы из XML или Mermaid и открывает их в редакторе draw.io
Smart Drawio
Smart Drawio Next
MCP-сервер и скилл для редактируемых диаграмм draw.io: агент создает XML по описанию, проверяет связи, чинит теги и применяет темы
Markdy
markdy-com
Анимированные диаграммы как код: текст превращается в пошаговое объяснение архитектуры. Библиотека, CLI и сервер MCP, вывод в HTML
Скилл рисует проверенные схемы архитектуры, процессов, последовательностей и потоков данных в один интерактивный HTML-файл
Next AI Draw.io: MCP-сервер и плагин, в которых агент рисует диаграммы draw.io на живом холсте в браузере, а вы правите их вручную
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| iso-topology (эта карточка) | нет | не нужна | 74 | |
| Diagram Design | нет | 66 598 | набор скиллов для оформления диаграмм, без текстового DSL с проверкой и ремонтом | |
| Генератор архитектурных диаграмм | нет | 7 583 | генератор схем для агентов без изометрии и машинного контракта | |
| Mermaid CLI | нет | 5 163 | рендерит плоские диаграммы Mermaid, изометрии у него нет |
Коротко о README
README подает iso-topology как инструмент диаграмм как кода с изометрическим выводом и ориентацией на агента. Показан пример YAML со стилями и отношениями размещения, быстрый запуск за минуту вручную и с агентом, затем цикл из семи команд: `capabilities`, `validate`, `evaluate`, `repair`, `render`, `snapshot`, `preview`. Дальше идут документация, галерея, бинарник без зависимостей и значки, включая логотипы брендов.