Servidor MCP de lienzo JSON

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para trabajar con archivos JSON Canvas según la especificación oficial . Este servidor permite crear, modificar y validar estructuras de datos Canvas infinitas.

Descripción general

El servidor JSON Canvas MCP proporciona una implementación completa de la especificación JSON Canvas 1.0, lo que permite:

• Creación y manipulación de datos de lienzo infinitos

• Soporte para todos los tipos de nodos (texto, archivo, enlace, grupo)

• Conexiones de borde con estilo y etiquetas

• Validación contra la especificación

• Rutas de salida configurables

Componentes

Recursos

El servidor expone los siguientes recursos:

• canvas://schema : Esquema JSON para validar archivos de lienzo

• canvas://examples : Archivos de lienzo de ejemplo que demuestran diferentes funciones

• canvas://templates : Plantillas para crear nuevos lienzos

Herramientas

Operaciones de nodo

• crear_nodo

  • Crea un nuevo nodo de cualquier tipo compatible

  • Aporte:

    • type (cadena): Tipo de nodo ("texto", "archivo", "enlace", "grupo")

    • properties (objeto): Propiedades específicas del nodo

      • Común: id , x , y , width , height , color

      • Específico del tipo: text , file , url , etc.

  • Devuelve: objeto de nodo creado

• nodo_de_actualización

  • Actualizar las propiedades de un nodo existente

  • Aporte:

    • id (cadena): ID del nodo a actualizar

    • properties (objeto): Propiedades a actualizar

  • Devuelve: objeto de nodo actualizado

• eliminar_nodo

  • Eliminar un nodo y sus bordes conectados

  • Aporte:

    • id (cadena): ID del nodo a eliminar

  • Devoluciones: Confirmación de éxito

Operaciones de borde

• crear_borde

  • Crear un nuevo borde entre nodos

  • Aporte:

    • id (cadena): identificador de borde único

    • fromNode (cadena): ID del nodo de origen

    • toNode (cadena): ID del nodo de destino

    • fromSide (cadena opcional): Lado de inicio ("arriba", "derecha", "abajo", "izquierda")

    • toSide (cadena opcional): lado final

    • color (cadena opcional): color del borde

    • label (cadena opcional): etiqueta de borde

  • Devuelve: objeto de borde creado

• actualizar_borde

  • Actualizar las propiedades de un borde existente

  • Aporte:

    • id (cadena): ID de borde que se actualizará

    • properties (objeto): Propiedades a actualizar

  • Devoluciones: objeto de borde actualizado

• eliminar_borde

  • Quitar un borde

  • Aporte:

    • id (cadena): ID del borde que se eliminará

  • Devoluciones: Confirmación de éxito

Operaciones de Canvas

• validar_lienzo

  • Validar un lienzo contra la especificación

  • Aporte:

    • canvas (objeto): Datos del canvas a validar

  • Devuelve: Resultados de validación con cualquier error

• lienzo_de_exportación

  • Exportar lienzo a diferentes formatos

  • Aporte:

    • format (cadena): Formato de destino ("json", "svg", "png")

    • canvas (objeto): Datos de Canvas para exportar

  • Devoluciones: Lienzo exportado en el formato solicitado

Uso con Claude Desktop

Estibador

Agregue esto a su claude_desktop_config.json :

UV

Configuración

El servidor se puede configurar mediante variables de entorno:

• OUTPUT_PATH : Directorio donde se guardarán los archivos de lienzo (predeterminado: "./output")

• FORMAT : Formato de salida predeterminado para archivos de lienzo (predeterminado: "json")

Edificio

Compilación de Docker

Construcción local

Ejemplo de uso

Creando un lienzo

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que 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.