MCP 工具參考

vpick 提供 34 個 MCP 工具，讓 AI Agent（如 Claude）能直接操控畫布、建立節點、生成圖片/影片/音訊/音樂，並管理專案。

畫布瀏覽

工具	說明
`get_canvas`	取得整個畫布的節點與連線資料
`get_canvas_info`	取得畫布摘要（節點數、連線數、類型分佈）
`list_nodes`	列出所有節點，含位置、尺寸、狀態、生成結果
`get_node`	取得單一節點的完整資料

範例：查看畫布

{ "method": "tools/call", "params": { "name": "get_canvas_info" } }

回傳：

{
  "nodeCount": 5,
  "edgeCount": 3,
  "nodeTypes": { "text": 1, "imageGenerator": 2, "videoGenerator": 1, "upload": 1 }
}

節點操作

工具	說明
`add_node`	建立新節點（支援所有類型）
`update_node`	更新節點的內容、參數、位置
`remove_nodes`	刪除一個或多個節點
`duplicate_nodes`	複製節點

支援的節點類型

type 值	節點類型
`text`	文字
`assistant`	AI 助手
`imageGenerator`	圖片生成
`videoGenerator`	影片生成
`audioGenerator`	語音生成（Voice Over）
`musicGenerator`	音樂生成
`lipsyncGenerator`	口型同步
`combine`	影片合併
`upload`	上傳
`list`	清單
`output`	輸出
`vocalSeparator`	人聲分離
`voiceChanger`	變聲器
`audioCombine`	音訊混合
`group`	群組

範例：建立影片生成節點

{
  "method": "tools/call",
  "params": {
    "name": "add_node",
    "arguments": {
      "type": "videoGenerator",
      "name": "產品廣告影片",
      "x": 600,
      "y": 200
    }
  }
}

範例：設定節點參數

{
  "method": "tools/call",
  "params": {
    "name": "update_node",
    "arguments": {
      "node_id": "node-abc123",
      "data": {
        "prompt": "A golden retriever running on the beach at sunset",
        "model": "kling-3.0/video",
        "duration": 5,
        "mode": "std"
      }
    }
  }
}

連線操作

工具	說明
`connect_nodes`	連接兩個節點（指定 handle）
`disconnect_nodes`	斷開連線

常用 Handle

來源 Handle	目標 Handle	說明
`text-out`	`text-in`	文字連接
`image-out`	`image-in`	圖片連接
`image-out`	`start-image-in`	影片首幀
`image-out`	`end-image-in`	影片尾幀
`video-out`	`videos-in`	影片合併
`audio-out`	`audio-in`	音訊連接
`list-out`	`list-in`	清單批次

範例：連接文字到影片生成

{
  "method": "tools/call",
  "params": {
    "name": "connect_nodes",
    "arguments": {
      "source_node_id": "node-text1",
      "source_handle": "text-out",
      "target_node_id": "node-video1",
      "target_handle": "text-in"
    }
  }
}

生成執行

工具	說明
`run_assistant`	執行 AI 助手（文字生成）
`run_image_generator`	執行圖片生成
`run_video_generator`	執行影片生成
`run_audio_generator`	執行語音生成
`run_music_generator`	執行音樂生成
`run_lipsync_generator`	執行口型同步
`run_audio_generator`	執行語音生成（TTS）
`run_music_generator`	執行音樂生成
`run_lipsync_generator`	執行口型同步
`run_vocal_separator`	執行人聲分離
`run_voice_changer`	執行變聲器
`run_audio_combine`	執行音訊混合
`run_combine`	合併影片

範例：生成影片

{
  "method": "tools/call",
  "params": {
    "name": "run_video_generator",
    "arguments": { "node_id": "node-video1" }
  }
}

注意：生成工具會自動檢查額度。若額度不足且已啟用自動儲值，會自動扣款。

工作流

工具	說明
`create_workflow`	建立工作流（定義執行順序）
`run_workflow`	執行已建立的工作流

工作流可定義多個步驟，按順序執行。適合「AI 生文案 → 生圖 → 生影片 → 合併」的連續流程。

專案管理

工具	說明
`list_projects`	列出所有專案
`create_project`	建立新專案
`switch_project`	切換到指定專案

佈局與群組

工具	說明
`move_nodes`	批次移動節點位置
`auto_layout`	自動排列節點（grid / row / column）
`create_group`	建立視覺群組
`update_group`	更新群組（新增/移除成員、調整大小）
`ungroup`	解散群組

歷史記錄與上傳

工具	說明
`list_generated_files`	查詢生成歷史
`get_generation_stats`	統計各模型使用量
`upload_image`	從 URL 下載圖片並上傳到畫布
`list_models`	列出所有可用模型及其規格

@ 引用語法

在 prompt 中使用 @節點名稱 可引用已連接節點的輸出結果：

根據 @產品描述 生成一張商品照片

支援的引用來源：

文字節點：引用 content 欄位
AI 助手：引用 result 欄位
圖片生成 / 上傳：引用圖片 URL
清單：引用清單項目

注意事項

避免並行修改：同一專案的 MCP 呼叫應依序執行，避免競態條件
節點命名：使用 add_node 時可指定 name 參數，方便 @ 引用
自動排版：省略 y 參數時，節點會自動放在現有節點下方
防重複執行：每個生成工具使用 claimNodeForProcessing() 防止重複觸發