Orrery — MCP-сервер для Claude Code: диаграммы архитектуры из YAML
Собирает анимированные схемы архитектуры и бизнес-процессов из одного YAML-файла: SVG, PNG, редактируемый draw.io, компонент React и HTML-просмотрщик.
claude mcp add orrery -- npx -y @sagargupta1610/orreryЧто делает Orrery
Orrery берёт одну спецификацию на YAML и раскладывает её сама — координаты писать не нужно. Движок Eclipse Layout Kernel расставляет вложенные границы, ведёт рёбра под прямыми углами и сохраняет порядок узлов, который вы задали. Иконки официальные: AWS, Azure, Google Cloud, Kubernetes, GitHub Octicons, IBM Carbon, плюс наборы технологотипов и нейтральных символов. Свои SVG тоже подойдут — их добавляют как local: и проверяют через orrery icons new и icons check.
Один и тот же файл превращается в разные фигуры. kind: переключает вывод на блок-схему, процесс BPMN с дорожками и пулами, диаграмму состояний UML, оргструктуру, mind map или карту клиентского пути. Отдельно есть модели данных с ключами и связями «вороньей лапой», диаграммы последовательности и дорожные карты по месяцам и кварталам. Спецификацию можно не писать руками: orrery import строит её из Terraform, CloudFormation, CDK, Docker Compose, манифестов Kubernetes или Mermaid, а каждый узел получает evidence: — файл, строку и идентификатор, откуда он взялся. orrery verify падает, если такая ссылка больше не существует.
Нужен Node.js 22 или новее. Сам CLI, движок раскладки, рендерер PNG, шрифты и облачные наборы иконок лежат в папке скилла, а вот наборы логотипов подгружаются из своих npm-библиотек при первом обращении к ним — без сети первый рендер с ними не пройдёт.
Какие задачи решает
- нарисовать схему доставки GitOps с официальными иконками AWS и Kubernetes
- получить редактируемый draw.io из той же спецификации, что и SVG для README
- построить диаграмму последовательности вызовов по шагам
- сверить схему с кодом и поймать узлы, которых больше нет в Terraform
- сделать дорожную карту по кварталам с вехами и зависимостями
Примеры запросов агенту
- Собери схему из
docs/hero.yamlи отдай SVG и PNG - Импортируй манифесты Kubernetes в спецификацию и покажи, что изменилось
- Сделай процесс BPMN с дорожками из этой спецификации
Как установить Orrery
Командой платформы
claude mcp add orrery -- npx -y @sagargupta1610/orreryКомандой платформы
codex mcp add orrery -- npx -y @sagargupta1610/orreryФайл настроек
{
"mcpServers": {
"orrery": {
"command": "npx",
"args": [
"-y",
"@sagargupta1610/orrery"
]
}
}
}Файл настроек
{
"servers": {
"orrery": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sagargupta1610/orrery"
]
}
}
}Командой платформы
gemini mcp add orrery npx -y @sagargupta1610/orreryПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Orrery
Как установить Orrery в Claude Code?
Одной командой: claude mcp add orrery -- npx -y @sagargupta1610/orrery.
Что делает Orrery?
Превращает YAML-спецификацию в анимированную схему архитектуры или бизнес-процесса и выводит её в SVG, PNG, draw.io, React-компонент, HTML-просмотрщик или текст Mermaid.
Что нужно для работы Orrery?
Node.js 22 или новее. Наборы логотипов и глифов подгружаются из npm при первом использовании, поэтому для первого рендера с ними нужен доступ в сеть.
