JSON キャンバス MCP サーバー

モデルコンテキストプロトコル（MCP）サーバー実装。公式仕様に従ってJSON Canvasファイルを操作するためのツールを提供します。このサーバーは、無限のCanvasデータ構造の作成、変更、検証を可能にします。

概要

JSON Canvas MCP サーバーは、JSON Canvas 1.0 仕様の完全な実装を提供し、次のことを可能にします。

無限のキャンバスデータの作成と操作
すべてのノードタイプ (テキスト、ファイル、リンク、グループ) をサポート
スタイルとラベルによるエッジ接続
仕様に対する検証
設定可能な出力パス

コンポーネント

リソース

サーバーは次のリソースを公開します。

canvas://schema : キャンバスファイルを検証するための JSON スキーマ
canvas://examples : さまざまな機能を示すサンプルキャンバスファイル
canvas://templates : 新しいキャンバスを作成するためのテンプレート

ツール

ノード操作

ノード作成
- サポートされている任意のタイプの新しいノードを作成します
- 入力：
  - type (文字列): ノードタイプ ("text", "file", "link", "group")
  - properties （オブジェクト）：ノード固有のプロパティ
    - 共通: id 、 x 、 y 、 width 、 height 、 color
    - タイプ固有: text 、 file 、 urlなど。
- 戻り値: 作成されたノードオブジェクト
ノードの更新
- 既存のノードのプロパティを更新する
- 入力：
  - id (文字列): 更新するノードID
  - properties (オブジェクト): 更新するプロパティ
- 戻り値: 更新されたノードオブジェクト
ノードの削除
- ノードとそれに接続されたエッジを削除する
- 入力：
  - id (文字列): 削除するノードID
- 戻り値: 成功確認

エッジオペレーション

エッジを作成する
- ノード間に新しいエッジを作成する
- 入力：
  - id (文字列): 一意のエッジ識別子
  - fromNode (文字列): ソースノードID
  - toNode (文字列): ターゲットノードID
  - fromSide (オプションの文字列): 開始側 ("top", "right", "bottom", "left")
  - toSide (オプションの文字列): 終了側
  - color (オプションの文字列): エッジの色
  - label （オプションの文字列）：エッジラベル
- 戻り値: 作成されたエッジオブジェクト
更新エッジ
- 既存のエッジのプロパティを更新する
- 入力：
  - id (文字列): 更新するエッジID
  - properties (オブジェクト): 更新するプロパティ
- 戻り値: 更新されたエッジオブジェクト
削除エッジ
- エッジを削除する
- 入力：
  - id (文字列): 削除するエッジID
- 戻り値: 成功確認

キャンバスオペレーション

検証キャンバス
- 仕様に基づいてキャンバスを検証する
- 入力：
  - canvas （オブジェクト）：検証するキャンバスデータ
- 戻り値: エラーを含む検証結果
エクスポートキャンバス
- キャンバスをさまざまな形式でエクスポートする
- 入力：
  - format (文字列): ターゲット形式 ("json", "svg", "png")
  - canvas (オブジェクト): エクスポートするキャンバスデータ
- 戻り値: 要求された形式でエクスポートされたキャンバス

Claude Desktopでの使用

ドッカー

これをclaude_desktop_config.jsonに追加します:

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

紫外線

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

構成

サーバーは環境変数を使用して設定できます。

OUTPUT_PATH : キャンバスファイルが保存されるディレクトリ（デフォルト: "./output"）
FORMAT : キャンバスファイルのデフォルトの出力形式 (デフォルト: "json")

建物

Dockerビルド

docker build -t mcp/jsoncanvas .

ローカルビルド

# 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

使用例

キャンバスを作成する

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")

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

JSON Canvas 1.0 仕様に従って無限のキャンバスデータ構造を作成、変更、検証できるモデルコンテキストプロトコルサーバー。

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-server-code-assist
abhishekbhakat
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.
Last updated -
12
1
Python
MIT License
Canvas MCP Server V2.0
DMontgomery40
A
security
F
license
A
quality
A Model Context Protocol server that enables interaction with the Canvas Learning Management System API, allowing users to manage courses, assignments, enrollments, and grades within Canvas.
Last updated -
54
37
33
JavaScript
Custom Context MCP Server
omer-ayhan
A
security
A
license
A
quality
A Model Context Protocol server that transforms text into structured JSON data using templates with placeholders.
Last updated -
2
1
TypeScript
MIT License
mcp-remote-server
hemanth
-
security
F
license
-
quality
A Model Context Protocol server that provides tools for fetching xkcd comics and resources for dynamic data retrieval, WebSocket echo functionality, and static JSON data testing.
Last updated -
5
TypeScript

View all related MCP servers

JSON Canvas MCP Server