Repolode
Enviar
yctimlin

yctimlin/mcp_excalidraw

Servidor MCP, CLI e skill para agentes que dão a agentes de programação com IA um canvas Excalidraw ativo para criar, capturar, editar e exportar diagramas.

Ver no GitHubSite
Estrelas
2,625
Forks
295
Issues abertas
42
Último commit
há 8 dias

O que é?

mcp-excalidraw-server permite que agentes de IA criem e editem diagramas do Excalidraw por programação em um canvas local ativo. Um agente pode adicionar, consultar, atualizar e excluir elementos individuais, organizá-los com operações de alinhamento, distribuição e agrupamento, e conferir o próprio trabalho por meio de uma descrição textual da cena ou de uma captura de tela renderizada.

O projeto oferece três formas de operar o mesmo canvas: uma skill para agentes com CLI (recomendada para agentes de programação), um servidor MCP via stdio com 26 ferramentas para clientes MCP como Claude Desktop, Cursor e Codex CLI, e uma API REST simples. O servidor do canvas é iniciado automaticamente quando um comando de desenho é executado, e as operações essenciais de desenho não exigem chaves de API nem contas.

Os diagramas podem ser exportados como arquivos .excalidraw para serem commitados junto com o código ou como arquivos .excalidraw.md para vaults do Obsidian. Capturas de tela e exportações em PNG/SVG são renderizadas sem interface gráfica no Node, enquanto a conversão de Mermaid e o controle da área visível ainda exigem uma aba do navegador aberta.

Recursos principais

  • 01Criar, ler, atualizar e excluir elementos individualmente em um canvas Excalidraw ativo.
  • 02Capturas de tela sem interface gráfica e exportação em PNG/SVG, para que os agentes possam inspecionar os próprios diagramas.
  • 03Ferramentas de layout para alinhar, distribuir, agrupar, bloquear e duplicar.
  • 04Snapshots nomeados e restauração para reverter uma cena.
  • 05Conversão de Mermaid para canvas e links de compartilhamento criptografados para excalidraw.com.
  • 06Funciona via CLI, servidor MCP ou API REST.

Casos de uso

  • Usar um agente de programação para desenhar diagramas de arquitetura e fluxogramas de uma base de código.
  • Exportar diagramas .excalidraw para um repositório, mantendo-os versionados junto com o código.
  • Gerar e manter diagramas em um vault do Obsidian.
  • Renderizar arquivos .excalidraw commitados em PNG no CI sem executar um navegador.

Início rápido

  1. 1

    Inicie o servidor do canvas com npx

    npx -y mcp-excalidraw-server start
  2. 2

    Desenhe um diagrama de teste com a CLI

    npx -y mcp-excalidraw-server describe
  3. 3

    Instale a skill do agente no seu diretório de skills

    npx -y mcp-excalidraw-server install-skill --dir <skills-root>

Antes de usar

  • A conversão de Mermaid requer uma aba do navegador aberta no canvas.
  • A página do canvas carrega as fontes do Excalidraw da CDN esm.sh.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCPFerramentas de CLI e terminalDiagramas, gráficos e visualizações animadas

Tópicos

#mcp#excalidraw#diagrams#ai-agent#cli#whiteboard#typescript

Perguntas frequentes

O que é mcp_excalidraw?
Servidor MCP, CLI e skill para agentes que dão a agentes de programação com IA um canvas Excalidraw ativo para criar, capturar, editar e exportar diagramas. mcp-excalidraw-server permite que agentes de IA criem e editem diagramas do Excalidraw por programação em um canvas local ativo. Um agente pode adicionar, consultar, atualizar e excluir elementos individuais, organizá-los com operações de alinhamento, distribuição e agrupamento, e conferir o próprio trabalho por meio de uma descrição textual da cena ou de uma captura de tela renderizada.
mcp_excalidraw é gratuito? Qual é a licença?
mcp_excalidraw é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp_excalidraw ainda é mantido?
Manutenção ativa. O último commit de mcp_excalidraw foi em 30 de out. de 2026.
Para que posso usar mcp_excalidraw?
Usar um agente de programação para desenhar diagramas de arquitetura e fluxogramas de uma base de código. Exportar diagramas .excalidraw para um repositório, mantendo-os versionados junto com o código. Gerar e manter diagramas em um vault do Obsidian. Renderizar arquivos .excalidraw commitados em PNG no CI sem executar um navegador.
Como instalar mcp_excalidraw?
Inicie o servidor do canvas com npx: npx -y mcp-excalidraw-server start Desenhe um diagrama de teste com a CLI: npx -y mcp-excalidraw-server describe Instale a skill do agente no seu diretório de skills: npx -y mcp-excalidraw-server install-skill --dir <skills-root>
Onde consigo mcp_excalidraw?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/yctimlin/mcp_excalidraw

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados