AI Diagram Maker MCP Server

AI Diagram Maker MCP Server

MCP-сервер для AI Diagram Maker — создавайте красивые диаграммы программной инженерии прямо в Cursor, Claude Desktop, Claude Code или любом MCP-совместимом AI-агенте.

• ai-diagram-maker-mcp 🌐 ☁️ - Генерируйте профессиональные программные диаграммы из описаний на простом английском языке.

Возможности

• 5 инструментов для всех типов входных данных: текст на естественном языке, код, ASCII-диаграмма, изображения и Mermaid
• Встроенный рендеринг — диаграммы отображаются прямо в чате через интерфейс MCP Apps, без скачивания
• URL диаграммы в ответах — откройте его в браузере для просмотра и редактирования диаграммы
• 5 типов диаграмм: flowchart, sequence, ERD, system architecture, UML
• Поддерживает транспорт stdio (локальный) и HTTP/Streamable HTTP (удалённый)

Содержание

• Предварительные требования
• Размещённый MCP-сервер
• Установка
• Конфигурация MCP-клиента
• Переменные окружения
• Инструменты
• Ключевые слова-триггеры
• Локальная настройка для разработчика
• Лицензия

Предварительные требования

1. Node.js 18+
2. Учётная запись AI Diagram Maker и API-ключ

Размещённый MCP-сервер

Публичная конечная точка MCP: https://mcp.aidiagrammaker.com/mcp (Streamable HTTP). Для этого варианта ничего устанавливать не нужно.

Аутентификация (HTTP)

Для удалённых HTTP-клиентов отправляйте ваш API-ключ с каждым запросом — не через переменные окружения:

• X-ADM-API-Key: <your_api_key> (рекомендуется), или
• Authorization: Bearer <your_api_key>

Используйте API-ключ из вашей учётной записи AI Diagram Maker (см. Предварительные требования).

Пример JSON для удалённого сервера

Добавьте это в MCP-конфигурацию вашего клиента (замените плейсхолдер API-ключа):

{
  "mcpServers": {
    "ai-diagram-maker": {
      "url": "https://mcp.aidiagrammaker.com/mcp",
      "headers": {
        "X-ADM-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Установка

Вариант A — размещённый сервер (рекомендуется)

Используйте пример JSON для удалённого сервера выше и подключите его к вашему клиенту, следуя разделу Конфигурация MCP-клиента. Глобальная установка не требуется.

Вариант B — локальный запуск через npx

Ничего не нужно устанавливать постоянно — npx запускает пакет по требованию. Имя пакета: ai-diagram-maker-mcp; добавьте @latest, если хотите, чтобы каждый вызов использовал самый свежий релиз (рекомендуется для разовых запусков и claude mcp add).

ADM_API_KEY=your_api_key npx ai-diagram-maker-mcp@latest

Конфигурация MCP-клиента

Cursor

Удалённый (рекомендуется)

Добавьте в ~/.cursor/mcp.json или Settings → MCP, используя пример JSON для удалённого сервера. Для этой настройки переменные окружения не требуются.

Локальный (stdio)

{
  "mcpServers": {
    "ai-diagram-maker": {
      "command": "npx",
      "args": ["-y", "ai-diagram-maker-mcp@latest"],
      "env": {
        "ADM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Опционально: добавьте "ADM_DEBUG": "1" в env для отладочного логирования — см. Переменные окружения.

Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ai-diagram-maker": {
      "command": "npx",
      "args": ["-y", "ai-diagram-maker-mcp@latest"],
      "env": {
        "ADM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code

macOS

claude mcp add ai-diagram-maker -t stdio -e ADM_API_KEY=<api_key> -- npx -y ai-diagram-maker-mcp@latest

Windows

claude mcp add ai-diagram-maker \
  --command "npx" \
  --args "-y,ai-diagram-maker-mcp@latest" \
  --env ADM_API_KEY=your_api_key_here

HTTP-транспорт (локальный или собственный хостинг)

Чтобы запустить HTTP-сервер самостоятельно (та же аутентификация через заголовки, что и в Аутентификация (HTTP)):

npx ai-diagram-maker-mcp@latest --transport http

Сервер слушает на $PORT или 3001. Направляйте клиентов на /mcp и отправляйте API-ключ с каждым запросом, используя указанные выше заголовки.

Переменные окружения

Переменная	Обязательна	По умолчанию	Описание
ADM_API_KEY	Да (только stdio)	—	Ваш API-ключ AI Diagram Maker (только для stdio-транспорта; удалённые HTTP-клиенты используют заголовки — см. Аутентификация (HTTP))
ADM_BASE_URL	Нет	https://app.aidiagrammaker.com	Переопределение для локального/промежуточного API; также используется как базовый URL для диаграмм в ответах инструментов
ADM_DEBUG	Нет	—	Установите в 1, true или yes, чтобы логировать параметры запроса от AI-агента и данные, отправляемые в API AI Diagram Maker. Логи выводятся в stderr. В Cursor откройте Output, выберите канал MCP или ai-diagram-maker, чтобы читать логи сервера.

Инструменты

generate_diagram_from_text

Сгенерировать диаграмму из описания на естественном языке.

Параметр	Тип	Обязателен	Описание
content	string	Да	Описание диаграммы на естественном языке
diagramType	enum	Нет	flowchart, sequence, erd, system_architecture, uml
prompt	string	Нет	Дополнительные инструкции по стилю/компоновке

Примеры запросов:

• "Создай микросервисную архитектуру с API-шлюзом, сервисом аутентификации, пользовательским сервисом и базой данных PostgreSQL"
• "Нарисуй sequence-диаграмму для процесса входа пользователя с генерацией JWT-токена"
• "adm покажи CI/CD пайплайн для Next.js приложения, развёрнутого на Vercel"

---

generate_diagram_from_json

Преобразовать JSON-структуру в диаграмму (отлично подходит для ответов API, схем баз данных, конфигурационных файлов).

Параметр	Тип	Обязателен	Описание
content	string	Да	JSON-строка для визуализации
prompt	string	Нет	Как интерпретировать JSON
diagramType	enum	Нет	Предпочтительный тип диаграммы

---

generate_diagram_from_ascii

Преобразовать ASCII-графику в аккуратную диаграмму.

Параметр	Тип	Обязателен	Описание
content	string	Да	Исходная ASCII-диаграмма
prompt	string	Нет	Инструкции по рендерингу
diagramType	enum	Нет	Предпочтительный тип диаграммы

---

generate_diagram_from_image

Преобразовать фото с доски, скриншот или любое изображение в чистую диаграмму.

Параметр	Тип	Обязателен	Описание
content	string	Да	Публичный URL изображения или data URI в формате base64
prompt	string	Нет	Что извлечь или как отрендерить
diagramType	enum	Нет	Предпочтительный тип выходной диаграммы

---

generate_diagram_from_mermaid

Преобразовать определение диаграммы Mermaid в D2 и вернуть PNG-изображение.

Параметр	Тип	Обязателен	Описание
content	string	Да	Исходный код диаграммы Mermaid (например, flowchart, sequenceDiagram, erDiagram)
prompt	string	Нет	Опциональная инструкция по компоновке или стилю
diagramType	enum	Нет	Предпочтительный тип диаграммы для преобразованного вывода

Ключевые слова-триггеры

AI-агент автоматически выберет нужный инструмент, когда вы используете фразы вроде:

• adm ...
• ai diagram maker ...
• create a diagram of ...
• show me a flowchart / sequence diagram / ERD / architecture ...
• visualise / draw / diagram ...

Локальная настройка для разработчика

Используйте эти шаги, чтобы клонировать репозиторий, собрать локально и запустить MCP-сервер с Node.

1. Клонирование репозитория

git clone https://github.com/erajasekar/ai-diagram-maker-mcp.git
cd ai-diagram-maker-mcp

2. Установка зависимостей

npm install

3. (Опционально) Перегенерация API-клиента

Если вы изменили спецификацию OpenAPI или конфигурацию AI Diagram Maker, перегенерируйте клиент:

npm run generate

4. Сборка

npm run build

Это компилирует TypeScript и собирает пользовательский интерфейс MCP-приложения в dist/. Точка входа сервера: dist/index.js.

5. Запуск локального MCP-сервера

stdio (по умолчанию) — для использования с Cursor, Claude Desktop и т.д.:

ADM_API_KEY=your_api_key node dist/index.js

Или используйте npm-скрипт:

ADM_API_KEY=your_api_key npm start

HTTP-транспорт — для удалённых клиентов или тестирования (те же заголовки, что и в Аутентификация (HTTP)):

ADM_API_KEY=your_api_key node dist/index.js --transport http

Или:

ADM_API_KEY=your_api_key npm run start:http

HTTP-сервер слушает на $PORT (по умолчанию 3001).

6. Использование локального сервера в Cursor

Направьте Cursor на ваш собранный сервер через Settings → MCP (или ~/.cursor/mcp.json):

{
  "mcpServers": {
    "ai-diagram-maker": {
      "command": "node",
      "args": ["/absolute/path/to/ai-diagram-maker-mcp/dist/index.js"],
      "env": {
        "ADM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Замените /absolute/path/to/ai-diagram-maker-mcp на фактический путь к вашему клонированному репозиторию. После изменения конфигурации перезапустите Cursor или перезагрузите MCP-серверы.

Для отладочного логирования добавьте "ADM_DEBUG": "1" в env — см. Переменные окружения.

Лицензия

MIT