AI Diagram Maker MCP Server

oficial

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

GitHub

Documentação

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)

Pré-requisitos

Node.js 18+
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