AI Diagram Maker MCP Server

oficial

Servidor MCP para AI Diagram Maker: genera diagramas de ingeniería de software hermosos directamente dentro de Cursor, Claude Desktop, Claude Code o cualquier agente de IA compatible con MCP.

GitHub

Documentación

Servidor MCP AI Diagram Maker

Servidor MCP para AI Diagram Maker — genera hermosos diagramas de ingeniería de software directamente dentro de Cursor, Claude Desktop, Claude Code o cualquier agente de IA compatible con MCP.

ai-diagram-maker-mcp 🌐 ☁️ - Genera diagramas de software profesionales a partir de descripciones en lenguaje natural.

Características

5 herramientas que cubren cada tipo de entrada: texto en lenguaje natural, código, diagrama ASCII, imágenes y Mermaid
Renderizado en línea — los diagramas aparecen directamente en el chat usando la interfaz MCP Apps, sin descargas
URL del diagrama en las respuestas — ábrela en tu navegador para ver y editar el diagrama
5 tipos de diagrama: diagrama de flujo, secuencia, ERD, arquitectura de sistema, UML
Soporta transportes stdio (local) y HTTP/HTTP transmitible (remoto)

Contenido

Requisitos previos
Servidor MCP alojado
Instalación
Configuración del cliente MCP
Variables de entorno
Herramientas
Palabras clave desencadenantes
Configuración para desarrolladores locales
Licencia

Requisitos previos

Node.js 18+
Una cuenta de AI Diagram Maker y una clave API

Servidor MCP alojado

El endpoint MCP público es https://mcp.aidiagrammaker.com/mcp (HTTP transmitible). No hay nada que instalar para esta opción.

Autenticación (HTTP)

Para clientes HTTP remotos, envía tu clave API en cada solicitud — no mediante variables de entorno:

X-ADM-API-Key: <your_api_key> (recomendado), o
Authorization: Bearer <your_api_key>

Usa la clave API de tu cuenta de AI Diagram Maker (ver Requisitos previos).

Ejemplo JSON para servidor remoto

Incorpora esto en la configuración MCP de tu cliente (reemplaza el marcador de posición de la clave API):

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

Instalación

Opción A — servidor alojado (recomendado)

Usa el ejemplo JSON para servidor remoto de arriba y conéctalo a tu cliente usando la Configuración del cliente MCP. No requiere instalación global.

Opción B — ejecutar localmente con npx

Nada que instalar permanentemente — npx ejecuta el paquete bajo demanda. El nombre del paquete es ai-diagram-maker-mcp; añade @latest si deseas que cada invocación resuelva la versión más reciente (recomendado para ejecuciones puntuales y claude mcp add).

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

Configuración del cliente MCP

Cursor

Remoto (recomendado)

Añadir a ~/.cursor/mcp.json o Configuración → MCP usando el ejemplo JSON para servidor remoto. No se requieren variables de entorno para esta configuración.

Local (stdio)

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

Opcional: añade "ADM_DEBUG": "1" a env para registro de depuración — ver Variables de entorno.

Claude Desktop

Añadir a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %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

Transporte HTTP (local o autoalojado)

Para ejecutar un servidor HTTP tú mismo (misma autenticación basada en cabeceras que Autenticación (HTTP)):

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

El servidor escucha en $PORT o 3001. Apunta los clientes a /mcp y envía la clave API con cada solicitud usando las cabeceras anteriores.

Variables de entorno

Variable	Requerida	Valor por defecto	Descripción
`ADM_API_KEY`	Sí (solo stdio)	—	Tu clave API de AI Diagram Maker (solo transporte stdio; los clientes HTTP remotos usan cabeceras — ver Autenticación (HTTP))
`ADM_BASE_URL`	No	`https://app.aidiagrammaker.com`	Anulación para API local/staging; también se usa como base para las URLs de diagramas en las respuestas de las herramientas
`ADM_DEBUG`	No	—	Establecer a `1`, `true` o `yes` para registrar los parámetros de solicitud del agente de IA y la carga útil enviada a la API de AI Diagram Maker. Los registros van a stderr. En Cursor, abre Salida, elige el canal MCP o ai-diagram-maker para leer los registros del servidor.

Herramientas

`generate_diagram_from_text`

Genera un diagrama a partir de una descripción en lenguaje natural.

Parámetro	Tipo	Requerido	Descripción
`content`	string	Sí	Descripción en lenguaje natural del diagrama
`diagramType`	enum	No	flowchart, sequence, erd, system_architecture, uml
`prompt`	string	No	Instrucción adicional de estilo/diseño

Ejemplos de prompts:

"Crea una arquitectura de microservicios con API gateway, servicio de autenticación, servicio de usuarios y base de datos PostgreSQL"
"Dibuja un diagrama de secuencia para el flujo de inicio de sesión de usuario con generación de token JWT"
"adm muestra el pipeline CI/CD para una aplicación Next.js desplegada en Vercel"

`generate_diagram_from_json`

Convierte una estructura JSON en un diagrama (ideal para respuestas de API, esquemas de bases de datos, archivos de configuración).

Parámetro	Tipo	Requerido	Descripción
`content`	string	Sí	Cadena JSON a visualizar
`prompt`	string	No	Cómo interpretar el JSON
`diagramType`	enum	No	Tipo de diagrama preferido

`generate_diagram_from_ascii`

Convierte arte ASCII en un diagrama pulido.

Parámetro	Tipo	Requerido	Descripción
`content`	string	Sí	Diagrama de arte ASCII sin procesar
`prompt`	string	No	Instrucciones de renderizado
`diagramType`	enum	No	Tipo de diagrama preferido

`generate_diagram_from_image`

Convierte una foto de pizarra, captura de pantalla o cualquier imagen en un diagrama limpio.

Parámetro	Tipo	Requerido	Descripción
`content`	string	Sí	URL de imagen pública o URI de datos base64
`prompt`	string	No	Qué extraer o cómo renderizar
`diagramType`	enum	No	Tipo de diagrama de salida preferido

`generate_diagram_from_mermaid`

Convierte una definición de diagrama Mermaid a D2 y devuelve una imagen PNG.

Parámetro	Tipo	Requerido	Descripción
`content`	string	Sí	Código fuente del diagrama Mermaid (ej. flowchart, sequenceDiagram, erDiagram)
`prompt`	string	No	Instrucción opcional de diseño o estilo
`diagramType`	enum	No	Tipo de diagrama preferido para la salida convertida

Palabras clave desencadenantes

El agente de IA seleccionará automáticamente la herramienta correcta cuando uses frases como:

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

Configuración para desarrolladores locales

Usa estos pasos para clonar el repositorio, compilar localmente y ejecutar el servidor MCP con Node.

1. Clonar el repositorio

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

2. Instalar dependencias

npm install

3. (Opcional) Regenerar el cliente API

Si cambias la especificación OpenAPI de AI Diagram Maker o la configuración, regenera el cliente:

npm run generate

4. Compilar

npm run build

Esto compila TypeScript y construye la interfaz de la app MCP en dist/. El punto de entrada del servidor es dist/index.js.

5. Ejecutar el servidor MCP local

stdio (por defecto) — para usar con Cursor, Claude Desktop, etc.:

ADM_API_KEY=your_api_key node dist/index.js

O usa el script npm:

ADM_API_KEY=your_api_key npm start

Transporte HTTP — para clientes remotos o pruebas (mismas cabeceras que Autenticación (HTTP)):

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

ADM_API_KEY=your_api_key npm run start:http

El servidor HTTP escucha en $PORT (por defecto 3001).

6. Usar el servidor local en Cursor

Apunta Cursor a tu servidor compilado mediante Configuración → MCP (o ~/.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"
      }
    }
  }
}

Reemplaza /absolute/path/to/ai-diagram-maker-mcp con la ruta real a tu repositorio clonado. Después de cambiar la configuración, reinicia Cursor o recarga los servidores MCP.

Para registro de depuración, añade "ADM_DEBUG": "1" a env — ver Variables de entorno.

Licencia

MIT