Repolode
Enviar
yctimlin

yctimlin/mcp_excalidraw

Servidor MCP, CLI y habilidad para agentes que ofrecen a los agentes de programación con IA un lienzo Excalidraw activo para dibujar, capturar, editar y exportar diagramas.

Ver en GitHubSitio web
Estrellas
2,625
Forks
295
Issues abiertos
42
Último commit
hace 7 días

¿Qué es?

mcp-excalidraw-server permite a los agentes de IA crear y editar diagramas de Excalidraw mediante programación en un lienzo local activo. Un agente puede añadir, consultar, actualizar y eliminar elementos individuales, organizarlos con operaciones de alineación, distribución y agrupación, y revisar su propio trabajo mediante una descripción textual de la escena o una captura renderizada.

El proyecto ofrece tres formas de controlar el mismo lienzo: una habilidad para agentes con una CLI (recomendada para agentes de programación), un servidor MCP stdio con 26 herramientas para clientes MCP como Claude Desktop, Cursor y Codex CLI, y una API REST sencilla. El servidor del lienzo se inicia automáticamente al ejecutar un comando de dibujo, y las funciones básicas de dibujo no requieren claves de API ni cuentas.

Los diagramas se pueden exportar como archivos .excalidraw para incluirlos en los commits junto con el código, o como archivos .excalidraw.md para bóvedas de Obsidian. Las capturas y las exportaciones a PNG/SVG se renderizan sin interfaz gráfica en Node, mientras que la conversión desde Mermaid y el control de la ventana gráfica siguen requiriendo una pestaña del navegador abierta.

Funciones clave

  • 01Crear, leer, actualizar y eliminar elementos individuales en un lienzo Excalidraw activo.
  • 02Capturas sin interfaz gráfica y exportación a PNG/SVG para que los agentes puedan revisar sus propios diagramas.
  • 03Herramientas de diseño para alinear, distribuir, agrupar, bloquear y duplicar.
  • 04Capturas con nombre y restauración para revertir una escena.
  • 05Conversión de Mermaid al lienzo y enlaces compartidos cifrados a excalidraw.com.
  • 06Funciona mediante una CLI, un servidor MCP o una API REST.

Casos de uso

  • Pedir a un agente de programación que dibuje diagramas de arquitectura y diagramas de flujo para una base de código.
  • Exportar diagramas .excalidraw a un repositorio para versionarlos junto con el código.
  • Generar y mantener diagramas en una bóveda de Obsidian.
  • Renderizar archivos .excalidraw versionados a PNG en CI sin ejecutar un navegador.

Inicio rápido

  1. 1

    Inicia el servidor del lienzo con npx

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

    Dibuja un diagrama de prueba con la CLI

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

    Instala la skill del agente en tu directorio de skills

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

Antes de usarlo

  • La conversión de Mermaid requiere tener abierta una pestaña del navegador con el lienzo.
  • La página del lienzo carga las fuentes de Excalidraw desde la CDN esm.sh.

En colecciones

Frameworks y apps de agentes de IA open sourceServidores MCPHerramientas de CLI y terminalDiagramas, gráficos y visualizaciones animadas

Temas

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

Preguntas frecuentes

¿Qué es mcp_excalidraw?
Servidor MCP, CLI y habilidad para agentes que ofrecen a los agentes de programación con IA un lienzo Excalidraw activo para dibujar, capturar, editar y exportar diagramas. mcp-excalidraw-server permite a los agentes de IA crear y editar diagramas de Excalidraw mediante programación en un lienzo local activo. Un agente puede añadir, consultar, actualizar y eliminar elementos individuales, organizarlos con operaciones de alineación, distribución y agrupación, y revisar su propio trabajo mediante una descripción textual de la escena o una captura renderizada.
¿mcp_excalidraw es gratuito? ¿Qué licencia tiene?
mcp_excalidraw es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mcp_excalidraw sigue mantenido?
Mantenimiento activo. El último commit de mcp_excalidraw fue el 30 oct 2026.
¿Para qué puedo usar mcp_excalidraw?
Pedir a un agente de programación que dibuje diagramas de arquitectura y diagramas de flujo para una base de código. Exportar diagramas .excalidraw a un repositorio para versionarlos junto con el código. Generar y mantener diagramas en una bóveda de Obsidian. Renderizar archivos .excalidraw versionados a PNG en CI sin ejecutar un navegador.
¿Cómo se instala mcp_excalidraw?
Inicia el servidor del lienzo con npx: npx -y mcp-excalidraw-server start Dibuja un diagrama de prueba con la CLI: npx -y mcp-excalidraw-server describe Instala la skill del agente en tu directorio de skills: npx -y mcp-excalidraw-server install-skill --dir <skills-root>
¿Dónde consigo mcp_excalidraw?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/yctimlin/mcp_excalidraw

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados