MCP Server Obsidian Jsoncanvas

🚀 JSON Canvas MCP サーバー

このサーバーは、モデルコンテキストプロトコル (MCP) を実装し、公式仕様 に準拠した JSON Canvas ファイルを処理するためのツールを提供します。このサーバーは、無限のキャンバスデータ構造の作成、変更、検証をサポートしています。

🚀 クイックスタート

JSON Canvas MCP サーバーは、JSON Canvas 1.0 仕様を完全に実装しており、以下の機能をサポートしています。

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

✨ 主な機能

📦 リソース

サーバーは以下のリソースを公開しています。

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

🛠️ ツール

ノード操作

• create_node

  • 任意のタイプの新しいノードを作成します。
  • 入力:
    • type（文字列）：ノードのタイプ（"text", "file", "link", "group"）
    • properties（オブジェクト）：ノード固有の属性
      • 共通属性: id, x, y, width, height, color
      • タイプ固有の属性: text, file, url など
  • 戻り値: 作成されたノードオブジェクト

• update_node

  • 既存のノードの属性を更新します。
  • 入力:
    • id（文字列）：更新するノードの ID
    • properties（オブジェクト）：更新する属性
  • 戻り値: 更新されたノードオブジェクト

• delete_node

  • ノードとそれに接続されたエッジを削除します。
  • 入力:
    • id（文字列）：削除するノードの ID
  • 戻り値: なし

エッジ操作

• create_edge

  • 新しいエッジを作成します。
  • 入力:
    • id（文字列）：エッジの一意の識別子
    • from_node（文字列）：開始ノードの ID
    • to_node（文字列）：目標ノードの ID
    • オプション属性:
      • label（文字列）：エッジのラベル
      • color（文字列）：エッジの色
      • style（オブジェクト）：エッジのスタイル
  • 戻り値: 作成されたエッジオブジェクト

• update_edge

  • 既存のエッジの属性を更新します。
  • 入力:
    • id（文字列）：更新するエッジの ID
    • properties（オブジェクト）：更新する属性
  • 戻り値: なし

• delete_edge

  • エッジを削除します。
  • 入力:
    • id（文字列）：削除するエッジの ID
  • 戻り値: なし

キャンバス操作

• add_node

  • キャンバスにノードを追加します。
  • 入力:
    • node（オブジェクト）：追加するノード
  • 戻り値: なし

• add_edge

  • キャンバスにエッジを追加します。
  • 入力:
    • edge（オブジェクト）：追加するエッジ
  • 戻り値: なし

• remove_node

  • キャンバスからノードとそれに関連するエッジを削除します。
  • 入力:
    • id（文字列）：削除するノードの ID
  • 戻り値: なし

• remove_edge

  • キャンバスからエッジを削除します。
  • 入力:
    • id（文字列）：削除するエッジの ID
  • 戻り値: なし

• save_canvas

  • 現在のキャンバスの状態をファイルに保存します。
  • 入力:
    • file_path（文字列）：保存するファイルのパス
  • 戻り値: なし

🛠️ 統合と設定

Claude Desktop との統合

Claude Desktop でこのサーバーを使用するには、以下の手順に従ってください。

1. 依存関係のインストール： すべての必要なライブラリとツールがインストールされていることを確認してください。
2. サーバーの起動： 適切なコマンドを使用して MCP サーバーを起動します。
3. キャンバスへの接続： Claude Desktop で JSON Canvas MCP をターゲットプラットフォームとして選択します。
4. 開発の開始： 提供されている API とツールを利用して、キャンバスの作成、編集、保存操作を行います。

環境変数の設定

• CANVAS_PATH：デフォルトのキャンバスファイルのパスを指定します。
• DEBUG_MODE：デバッグモードを有効または無効にします。
• LOG_LEVEL：ログ記録レベルを設定します（"debug", "info", "warning", "error", "critical"）。

💻 使用例

キャンバスの作成

from jsoncanvas import Canvas, TextNode, Edge

# ノードの作成
title = TextNode(
    id="title",
    x=100,
    y=100,
    width=400,
    height=100,
    text="# Hello Canvas\n\nこれはデモです。",
    color="#4285F4"
)

info = TextNode(
    id="info",
    x=600,
    y=100,
    width=300,
    height=100,
    text="ここに詳細情報があります",
    color="2"  # 事前定義された色を使用
)

# キャンバスの作成
canvas = Canvas()
canvas.add_node(title)
canvas.add_node(info)

# ノードの接続
edge = Edge(
    id="edge1",
    from_node="title",
    to_node="info",
    from_side="right",
    to_side="left",
    label="接続"
)
canvas.add_edge(edge)

# キャンバスの保存
canvas.save("example.canvas")

📄 ライセンス

この MCP サーバーは MIT ライセンスの下で配布されています。これは、MIT ライセンスの条項と条件に従って、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。