Servidor MCP de Excalidraw: potente API de dibujo para la integración con LLM

Un servidor integral de Protocolo de Contexto de Modelo (MCP) que permite una interacción fluida con diagramas y dibujos de Excalidraw. Este servidor proporciona a los LLM (Grandes Modelos de Lenguaje) la capacidad de crear, modificar, consultar y manipular dibujos de Excalidraw mediante una API estructurada y fácil de usar para desarrolladores.

Características

Control completo de elementos de Excalidraw : cree, actualice, elimine y consulte cualquier elemento de Excalidraw
Manipulación avanzada de elementos : agrupar, alinear, distribuir, bloquear y desbloquear elementos
Gestión de recursos : acceda y modifique información de escenas, bibliotecas, temas y elementos.
Fácil integración : funciona con Claude Desktop y otras plataformas LLM
Compatibilidad con Docker : implementación sencilla con opciones de contenedorización

Related MCP server: Excalidraw MCP Server

Referencia de herramientas API

Creación y modificación de elementos

crear_elemento
- Crea un nuevo elemento Excalidraw (rectángulo, elipse, diamante, etc.)
- Entradas requeridas: type , coordenadas x , y
- Entradas opcionales: dimensiones, colores, propiedades de estilo
elemento_actualización
- Actualizar un elemento Excalidraw existente por ID
- Entrada obligatoria: id del elemento a actualizar
- Entradas opcionales: cualquier propiedad del elemento a modificar
eliminar_elemento
- Eliminar un elemento de Excalidraw
- Entrada obligatoria: id del elemento a eliminar
elementos de consulta
- Elementos de consulta con filtrado opcional
- Entradas opcionales: type para filtrar por tipo de elemento, filter objeto con pares clave-valor

Gestión de recursos

obtener_recurso
- Obtenga un recurso específico como información de la escena o todos los elementos
- Entrada requerida: tipo resource (escena, biblioteca, tema, elementos)

Organización de elementos

elementos_del_grupo
- Agrupar varios elementos juntos
- Entrada obligatoria: elementIds matriz de ID de elementos a agrupar
desagrupar_elementos
- Desagrupar un grupo de elementos
- Entrada obligatoria: groupId del grupo a desagrupar
alinear_elementos
- Alinear varios elementos según la alineación especificada
- Entradas obligatorias: matriz elementIds y alignment (izquierda, centro, derecha, arriba, medio, abajo)
distribuir_elementos
- Distribuir elementos uniformemente en el espacio
- Entradas obligatorias: matriz elementIds y direction (horizontal o vertical)
elementos de bloqueo
- Elementos de bloqueo para evitar modificaciones
- Entrada obligatoria: elementIds matriz de elementos a bloquear
elementos de desbloqueo
- Desbloquear elementos para permitir modificaciones
- Entrada obligatoria: elementIds matriz de elementos a desbloquear

Integración con Claude Desktop

Para utilizar este servidor con la aplicación Claude Desktop, agregue la siguiente configuración a la sección "mcpServers" de su claude_desktop_config.json :

{ "mcpServers": { "excalidraw": { "command": "node", "args": ["src/index.js"], "env": { "LOG_LEVEL": "info", "DEBUG": "false" } } } }

Integración con Cursor

Para utilizar este servidor con Cursor, cree un archivo .cursor/mcp.json en su espacio de trabajo con la siguiente configuración:

{ "mcpServers": { "excalidraw": { "command": "node", "args": [ "/path/to/your/directory/mcp_excalidraw/src/index.js" ], "env": { "LOG_LEVEL": "info", "DEBUG": "false" } } } }

Asegúrese de:

Reemplace /path/to/your/directory con la ruta absoluta real a su instalación de mcp_excalidraw
Crea el directorio .cursor si no existe
Asegúrese de que la ruta a index.js sea correcta y que el archivo exista

Integración de Docker

{ "mcpServers": { "excalidraw": { "command": "docker", "args": ["run", "-i", "--rm", "mcp/excalidraw"], "env": { "LOG_LEVEL": "info", "DEBUG": "false" } } } }

Guía de instalación

Instalación de NPM

# Install dependencies npm install # Start the server npm start

Instalación de Docker

# Build the Docker image docker build -t mcp/excalidraw . # Run the container docker run -i --rm mcp/excalidraw

Opciones de configuración

El servidor se puede configurar utilizando las siguientes variables de entorno:

LOG_LEVEL - Establece el nivel de registro (predeterminado: "info")
DEBUG - Habilitar el modo de depuración (predeterminado: "falso")
DEFAULT_THEME - Establece el tema predeterminado (predeterminado: "claro")

Ejemplos de uso

A continuación se muestran algunos ejemplos prácticos de cómo utilizar el servidor Excalidraw MCP:

Creación de un elemento rectangular

{ "type": "rectangle", "x": 100, "y": 100, "width": 200, "height": 100, "backgroundColor": "#ffffff", "strokeColor": "#000000", "strokeWidth": 2, "roughness": 1 }

Consulta de elementos específicos

{ "type": "rectangle", "filter": { "strokeColor": "#000000" } }

Agrupación de múltiples elementos

{ "elementIds": ["elem1", "elem2", "elem3"] }

Licencia

Este servidor Excalidraw MCP cuenta con la licencia MIT. Puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.