Structurizr MCP server
Экспериментальный MCP-сервер Structurizr: проверяет модель C4 в DSL, экспортирует виды в Mermaid и PlantUML и работает с рабочими пространствами на сервере
- 507 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Инструменты создают, обновляют и удаляют рабочие пространства на сервере Structurizr
- Ключ API от сервера передается параметром вызова и виден в запросе агента
Установка
- Работает в
Ручная установка
Склонируй https://github.com/structurizr/structurizr, собери проект через ./mvnw с JDK 21 и запусти ./mcp.sh. Затем найди в docs.structurizr.com/ai/mcp актуальный адрес и способ подключения и добавь сервер в конфигурацию агента. Ключ API от сервера Structurizr не запрашивай у пользователя без необходимости и не записывай в файлы.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты создают, обновляют и удаляют рабочие пространства на сервере Structurizr
- Ключ API от сервера передается параметром вызова и виден в запросе агента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий structurizr/structurizr содержит инструмент «модели как код» для архитектурной нотации C4, а в папке structurizr-mcp лежит экспериментальный MCP-сервер к нему. Архитектуру пишут на Structurizr DSL, и из одной модели получают несколько диаграмм. Автор нотации C4 создал и сам инструмент, и в README он назван эталонной реализацией. Модуль structurizr-mcp дает агенту три группы инструментов. Для DSL это `validate`, `parse` и `inspect`: агент проверяет, разбирает и изучает текст рабочего пространства. Для диаграмм это `export-mermaid`, `export-plantuml` и `export-c4plantuml`, которые выгружают виды в Mermaid, PlantUML или C4-PlantUML. Для сервера Structurizr это `getWorkspace`, `getWorkspaces`, `createWorkspace`, `updateWorkspace` и `deleteWorkspace`: каждому нужен адрес сервера и необязательный ключ API. Сервер собран на Spring AI, работает по протоколу без состояния и запускается скриптом mcp.sh из war-файла. Рядом лежат Dockerfile для образов на Eclipse Temurin. Инструкции по подключению к агенту опубликованы в документации на docs.structurizr.com/ai/mcp.
Для кого. Для архитекторов и разработчиков, которые описывают системы в нотации C4 на Structurizr DSL и хотят, чтобы агент проверял модель и выгружал диаграммы.
Подходит, если
- Агент написал или поправил workspace.dsl, и нужно сразу проверить синтаксис и ссылки в модели
- Из одной модели C4 требуется выгрузить виды в Mermaid для вики или в PlantUML для старого конвейера документации
- Команда держит рабочие пространства на сервере Structurizr, и агент должен получать их список и обновлять
- Нужно понять структуру чужой модели: инструмент inspect покажет, что в ней описано
- Хотите проверить гипотезу «модели как код» с агентом, не собирая собственный разбор DSL
Не подходит, если
- Нужна произвольная схема или блок-диаграмма: сервер работает только с моделями Structurizr DSL
- Нужен стабильный продукт: сам автор называет MCP-сервер экспериментальным
- Нет Java: запуск идет через war-файл, для его сборки нужен Maven и JDK
- Удаление и изменение рабочих пространств на общем сервере вам не нужно: тогда не давайте агенту ключ API
Пример запроса к агенту
Проверь workspace.dsl через Structurizr MCP и выгрузи все виды в MermaidMCP
- Транспорт
- http
- Авторизация
- не нужна
Ограничения
Автор подписал MCP-сервер как экспериментальный. Готового пакета в npm или образа в README нет: скрипт mcp.sh запускает structurizr-mcp-1.0.0.war из папки target, поэтому проект надо собрать самостоятельно через Maven wrapper (mvnw). Нужна Java, в Dockerfile используется Eclipse Temurin 21. Сервер работает по HTTP без состояния, а не через stdio. Инструменты для рабочих пространств принимают адрес сервера Structurizr и ключ API как параметры вызова, поэтому ключ окажется в запросе агента. Подробности подключения к агентам автор вынес в отдельную документацию, в самом репозитории их нет.
Как отключить. Остановите процесс java с structurizr-mcp и удалите запись сервера из конфигурации вашего агента. Собранные файлы лежат в папке structurizr-mcp/target.
Частые вопросы
Как подключить Structurizr MCP к Claude Code или Cursor?
Соберите проект, запустите ./mcp.sh и добавьте адрес сервера в конфигурацию агента. Точный порядок и адрес автор описал в документации docs.structurizr.com/ai/mcp. В Dockerfile задан порт 8080 через переменную PORT.
Какие инструменты есть у сервера?
Три для разбора DSL: `validate`, `parse`, `inspect`. Три для выгрузки: `export-mermaid`, `export-plantuml`, `export-c4plantuml`. Пять для сервера Structurizr: получить одно пространство, получить все, создать, обновить и удалить.
Нужен ли сервер Structurizr для работы?
Нет. Инструменты проверки DSL и выгрузки диаграмм принимают текст модели прямо в вызове. Сервер Structurizr нужен только для пяти инструментов с рабочими пространствами.
Чем Structurizr отличается от обычных генераторов диаграмм?
Модель описывается один раз в Structurizr DSL, а виды на разных уровнях C4 строятся из нее. Автор C4 называет инструмент эталонной реализацией нотации. Можно попробовать Structurizr без установки в playground.structurizr.com или запустить локально через готовый образ Docker.
Можно ли запустить сервер в Docker?
В репозитории есть два Dockerfile, на Eclipse Temurin 21 Alpine и Noble. Они копируют собранный war-файл в образ и запускают его командой java -jar. Готового образа в реестре README не указывает, собрать его придется самому.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПлагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их
Локальный граф знаний о коде с историей версий: MCP-сервер отвечает агенту, кто вызывает функцию и что сломается от правки
MCP-сервер, который один раз строит граф кода проекта и отдает агенту готовые ответы вместо повторного перечитывания файлов
CLI собирает готовый MCP-сервер на TypeScript из спецификации OpenAPI 3: инструменты, валидация и авторизация генерируются сами
rust-analyzer MCP — навигация по коду Rust для агента
r3bl-rust-analyzer-mcp-server
MCP-сервер на потоках Rust: агент получает подсказки, переходы к определениям, ссылки, форматирование и диагностику компилятора от rust-analyzer
Docker-сервер с read-only ядром и подключаемыми модулями: метаданные, код, формы и связи нескольких конфигураций 1С через единый MCP-контракт
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Structurizr MCP server (эта запись) | да | не нужна | 507 | |
| MCP Mermaid | нет | не нужна | 646 | рисует диаграммы Mermaid из текста, но не хранит единую модель C4 и не проверяет ее |
| Archify | нет | 91 202 | скилл рисует архитектурные схемы и диаграммы сам, без отдельной модели в DSL |
Коротко о README
Корневой README коротко представляет Structurizr как инструмент «модели как код» для нотации C4 и показывает два быстрых старта: онлайн-песочницу playground.structurizr.com и локальный запуск готового образа Docker. Ссылки ведут на пример DSL, обучающий разбор и документацию. Папка structurizr-mcp содержит собственный README из одной строки о том, что сервер экспериментальный, и ссылку на документацию.