ArchSmith — MCP-сервер для Claude Code: диаграммы архитектуры
Сервер проверяет архитектурное описание в JSON и строит по нему SVG-диаграмму. Пригодится, когда агенту нужно подготовить или проверить схему архитектуры.
claude mcp add archsmith -- npx -y @archsmith/mcp-serverЧто делает ArchSmith
ArchSmith предоставляет агенту инструменты для получения JSON Schema и реестров, проверки описания диаграммы и рендеринга SVG. Проверка выполняется перед рендерингом. Сервер работает через stdio и обращается к функциям рендерера напрямую, а не запускает CLI.
По умолчанию шрифты в SVG не встраиваются. Если включить embedFonts, SVG может превысить порог в 25 000 байт: тогда результат выдаётся ссылкой на ресурс, который можно прочитать через resources/read. Ссылки хранятся в памяти; после 20 новых рендеров старые записи могут вытесняться. Это важно, если агенту понадобится прочитать результат позже.
Для подключения в Claude Code выполните claude mcp add archsmith -- npx -y @archsmith/mcp-server. Сервер также поддерживает Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed и Gemini CLI.
Какие задачи решает
- проверить JSON-описание архитектурной диаграммы
- получить SVG из описания архитектуры
- узнать актуальную схему JSON IR для агента
- получить сведения о доступных реестрах
Примеры запросов агенту
- Проверь это JSON-описание архитектуры и покажи ошибки.
- Построй SVG-диаграмму по этому описанию.
- Получи актуальную схему JSON IR и создай по ней описание архитектуры.
Как установить ArchSmith
Командой платформы
claude mcp add archsmith -- npx -y @archsmith/mcp-serverКомандой платформы
codex mcp add mcp-server -- npx -y @archsmith/mcp-serverФайл настроек
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@archsmith/mcp-server"
]
}
}
}Файл настроек
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@archsmith/mcp-server"
]
}
}
}Командой платформы
gemini mcp add mcp-server npx -y @archsmith/mcp-serverПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ArchSmith
Как установить ArchSmith в Claude Code?
Выполните claude mcp add archsmith -- npx -y @archsmith/mcp-server. Сервер подключится через stdio.
Что делает ArchSmith?
Он предоставляет агенту инструменты для проверки архитектурного описания в JSON и рендеринга SVG, а также для чтения схемы и реестров.
Что происходит, если SVG больше 25 000 байт?
Сервер возвращает ссылку на ресурс вместо встраивания SVG в ответ инструмента. Прочитать ресурс можно через resources/read; в памяти остаются последние 20 рендеров.
