MCP Server Obsidian Jsoncanvas

🚀 JSON Canvas MCP 服務器

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. 連接到 Canvas：在 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 文件。