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

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 :

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:

Asegúrese de:

1. Reemplace /path/to/your/directory con la ruta absoluta real a su instalación de mcp_excalidraw

2. Crea el directorio .cursor si no existe

3. Asegúrese de que la ruta a index.js sea correcta y que el archivo exista

Integración de Docker

Guía de instalación

Instalación de NPM

Instalación de Docker

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

Consulta de elementos específicos

Agrupación de múltiples elementos

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.