AI Diagram Maker MCP

Servidor MCP AI Diagram Maker

Servidor MCP para AI Diagram Maker — gere belos diagramas de engenharia de software diretamente no Cursor, Claude Desktop, Claude Code ou qualquer agente de IA compatível com MCP.

• ai-diagram-maker-mcp 🌐 ☁️ - Gere diagramas de software profissionais a partir de descrições em linguagem natural.

Funcionalidades

• 5 ferramentas cobrindo todos os tipos de entrada: texto em linguagem natural, código, diagrama ASCII, imagens e Mermaid
• Renderização inline — os diagramas aparecem diretamente no chat usando a UI do MCP Apps, sem downloads
• URL do diagrama nas respostas — abra no seu navegador para visualizar e editar o diagrama
• 5 tipos de diagrama: fluxograma, sequência, ERD, arquitetura de sistema, UML
• Suporta transportes stdio (local) e HTTP/HTTP Transmissível (remoto)

Conteúdo

• Pré-requisitos
• Servidor MCP hospedado
• Instalação
• Configuração do cliente MCP
• Variáveis de ambiente
• Ferramentas
• Palavras-chave de gatilho
• Configuração local para desenvolvedores
• Licença

Pré-requisitos

1. Node.js 18+
2. Uma conta no AI Diagram Maker e chave de API

Servidor MCP hospedado

O endpoint MCP público é https://mcp.aidiagrammaker.com/mcp (HTTP Transmissível). Nada para instalar nesta opção.

Autenticação (HTTP)

Para clientes HTTP remotos, envie sua chave de API em cada requisição — não via variáveis de ambiente:

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

Use a chave de API da sua conta AI Diagram Maker (veja Pré-requisitos).

Exemplo JSON para servidor remoto

Incorpore isto na configuração MCP do seu cliente (substitua o placeholder da chave de API):

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

Instalação

Opção A — servidor hospedado (recomendado)

Use o exemplo JSON para servidor remoto acima e conecte-o ao seu cliente usando a Configuração do cliente MCP. Sem instalação global.

Opção B — executar localmente com npx

Nada para instalar permanentemente — npx executa o pacote sob demanda. O nome do pacote é ai-diagram-maker-mcp; adicione @latest se quiser que cada invocação resolva a versão mais recente (recomendado para execuções pontuais e claude mcp add).

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

Configuração do cliente MCP

Cursor

Remoto (recomendado)

Adicione ao ~/.cursor/mcp.json ou Configurações → MCP usando o exemplo JSON para servidor remoto. Nenhuma variável de ambiente é necessária para esta configuração.

Local (stdio)

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

Opcional: adicione "ADM_DEBUG": "1" ao env para logs de depuração — veja Variáveis de ambiente.

Claude Desktop

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %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 ou auto-hospedado)

Para executar um servidor HTTP você mesmo (mesma autenticação por cabeçalho do Autenticação (HTTP)):

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

O servidor escuta em $PORT ou 3001. Aponte os clientes para /mcp e envie a chave de API com cada requisição usando os cabeçalhos acima.

Variáveis de ambiente

Variável	Obrigatória	Padrão	Descrição
ADM_API_KEY	Sim (apenas stdio)	—	Sua chave de API do AI Diagram Maker (apenas transporte stdio; clientes HTTP remotos usam cabeçalhos — veja Autenticação (HTTP))
ADM_BASE_URL	Não	https://app.aidiagrammaker.com	Substituição para API local/staging; também usada como base para URLs de diagrama nas respostas das ferramentas
ADM_DEBUG	Não	—	Defina como 1, true ou yes para registrar parâmetros de requisição do agente de IA e o payload enviado à API do AI Diagram Maker. Logs vão para stderr. No Cursor, abra Saída, escolha o canal MCP ou ai-diagram-maker para ler os logs do servidor.

Ferramentas

generate_diagram_from_text

Gera um diagrama a partir de uma descrição em linguagem natural.

Parâmetro	Tipo	Obrigatório	Descrição
content	string	Sim	Descrição em linguagem natural do diagrama
diagramType	enum	Não	flowchart, sequence, erd, system_architecture, uml
prompt	string	Não	Instrução adicional de estilo/layout

Exemplos de prompts:

• "Crie uma arquitetura de microsserviços com API gateway, serviço de autenticação, serviço de usuário e banco de dados PostgreSQL"
• "Desenhe um diagrama de sequência para o fluxo de login do usuário com geração de token JWT"
• "adm mostre o pipeline CI/CD para uma aplicação Next.js implantada na Vercel"

---

generate_diagram_from_json

Converte uma estrutura JSON em um diagrama (ótimo para respostas de API, esquemas de banco de dados, arquivos de configuração).

Parâmetro	Tipo	Obrigatório	Descrição
content	string	Sim	String JSON para visualizar
prompt	string	Não	Como interpretar o JSON
diagramType	enum	Não	Tipo de diagrama preferido

---

generate_diagram_from_ascii

Converte arte ASCII em um diagrama polido.

Parâmetro	Tipo	Obrigatório	Descrição
content	string	Sim	Diagrama em arte ASCII bruto
prompt	string	Não	Instruções de renderização
diagramType	enum	Não	Tipo de diagrama preferido

---

generate_diagram_from_image

Converte uma foto de quadro branco, captura de tela ou qualquer imagem em um diagrama limpo.

Parâmetro	Tipo	Obrigatório	Descrição
content	string	Sim	URL pública da imagem ou URI de dados base64
prompt	string	Não	O que extrair ou como renderizar
diagramType	enum	Não	Tipo de diagrama de saída preferido

---

generate_diagram_from_mermaid

Converte uma definição de diagrama Mermaid para D2 e retorna uma imagem PNG.

Parâmetro	Tipo	Obrigatório	Descrição
content	string	Sim	Fonte do diagrama Mermaid (ex: flowchart, sequenceDiagram, erDiagram)
prompt	string	Não	Instrução opcional de layout ou estilo
diagramType	enum	Não	Tipo de diagrama preferido para a saída convertida

Palavras-chave de gatilho

O agente de IA selecionará automaticamente a ferramenta certa quando você usar frases como:

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

Configuração local para desenvolvedores

Use estes passos para clonar o repositório, compilar localmente e executar o servidor MCP com Node.

1. Clone o repositório

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

2. Instale as dependências

npm install

3. (Opcional) Regenere o cliente da API

Se você alterar a especificação OpenAPI ou a configuração do AI Diagram Maker, regenere o cliente:

npm run generate

4. Compile

npm run build

Isso compila TypeScript e constrói a UI do MCP App em dist/. O ponto de entrada do servidor é dist/index.js.

5. Execute o servidor MCP local

stdio (padrão) — para uso com Cursor, Claude Desktop, etc.:

ADM_API_KEY=your_api_key node dist/index.js

Ou use o script npm:

ADM_API_KEY=your_api_key npm start

Transporte HTTP — para clientes remotos ou testes (mesmos cabeçalhos do Autenticação (HTTP)):

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

Ou:

ADM_API_KEY=your_api_key npm run start:http

O servidor HTTP escuta em $PORT (padrão 3001).

6. Use o servidor local no Cursor

Aponte o Cursor para o seu servidor compilado via Configurações → MCP (ou ~/.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"
      }
    }
  }
}

Substitua /absolute/path/to/ai-diagram-maker-mcp pelo caminho real para o seu repositório clonado. Após alterar a configuração, reinicie o Cursor ou recarregue os servidores MCP.

Para logs de depuração, adicione "ADM_DEBUG": "1" ao env — veja Variáveis de ambiente.

Licença

MIT