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

Related MCP server: MCP REST API Server

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 :

{
  "mcpServers": {
    "jsoncanvas": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "canvas-data:/data",
        "mcp/jsoncanvas"
      ],
      "env": {
        "OUTPUT_PATH": "/data/output"
      }
    }
  }
}

UV

{
  "mcpServers": {
    "jsoncanvas": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/jsoncanvas",
        "run",
        "mcp-server-jsoncanvas"
      ],
      "env": {
        "OUTPUT_PATH": "./output"
      }
    }
  }
}

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

docker build -t mcp/jsoncanvas .

Construcción local

# Install uv if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create virtual environment and install dependencies
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

# Run tests
pytest

Ejemplo de uso

Creando un lienzo

from jsoncanvas import Canvas, TextNode, Edge

# Create nodes
title = TextNode(
    id="title",
    x=100,
    y=100,
    width=400,
    height=100,
    text="# Hello Canvas\n\nThis is a demonstration.",
    color="#4285F4"
)

info = TextNode(
    id="info",
    x=600,
    y=100,
    width=300,
    height=100,
    text="More information here",
    color="2"  # Using preset color
)

# Create canvas
canvas = Canvas()
canvas.add_node(title)
canvas.add_node(info)

# Connect nodes
edge = Edge(
    id="edge1",
    from_node="title",
    to_node="info",
    from_side="right",
    to_side="left",
    label="Connection"
)
canvas.add_edge(edge)

# Save canvas
canvas.save("example.canvas")

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.