Picsart GenAI MCP

Picsart MCP 伺服器將完整的模型目錄公開為 Model Context Protocol 工具。將它連接到任何相容 MCP 的代理程式，該代理程式就能透過自然語言或結構化工具呼叫，在 201 個模型中生成影像、影片和音訊。

MCP 新手？請先閱讀 什麼是 MCP？。

前置需求

1. 安裝 gen-ai CLI — 請參閱 安裝。
2. 執行 gen-ai login 一次（會開啟瀏覽器進行 OAuth）。

這樣就完成了。MCP 伺服器（gen-ai-mcp）隨附於 CLI，並使用相同的憑證。

連接到您的代理程式

Claude Code

claude mcp add picsart-gen-ai -- gen-ai-mcp

然後在任何對話中使用它：

「使用 Flux 2 Pro 生成一張白色背景的產品圖片，4:3 長寬比。」

如需完整的 Claude Code 設定（包括 Skills 和疑難排解），請參閱 Claude Code 整合。

Cursor

將以下內容新增到您的 Cursor MCP 設定檔（.cursor/mcp.json 或同等檔案）：

{
  "mcpServers": {
    "picsart-gen-ai": {
      "command": "gen-ai-mcp"
    }
  }
}

請參閱 Cursor 整合。

Windsurf

新增到您的 Windsurf MCP 設定：

{
  "mcpServers": {
    "picsart-gen-ai": {
      "command": "gen-ai-mcp"
    }
  }
}

請參閱 Windsurf 整合。

VS Code (Copilot)

新增到您工作區的 .vscode/mcp.json 或您的使用者設定：

{
  "servers": {
    "picsart-gen-ai": {
      "type": "stdio",
      "command": "gen-ai-mcp"
    }
  }
}

請參閱 VS Code 整合。

Codex (OpenAI)

codex mcp add picsart-gen-ai -- gen-ai-mcp

請參閱 Codex 整合。

ChatGPT 和其他 MCP 用戶端

請參閱 ChatGPT 整合 或官方頁面 picsart.com/gen-ai-mcp 以取得目前的連接器設定。

---

工具目錄

連接後會公開下列生成、目錄和 Drive 工具，以及 picsart_media_* 工具，用於從您已有的素材建構影片和影像。

想要建構而非生成？

Picsart Media Studio 是專門用於此類工作的連接器。它需要單獨新增和登入，並且可以與此連接器並行使用。

連接後，代理程式即可使用所有工具。不消耗點數的工具可依需求無限次免費呼叫。

生成

工具	用途	消耗點數
picsart_generate	端對端執行任何模型（影像 / 影片 / 音訊 / 文字）	是
picsart_remove_bg	移除影像背景	是
picsart_change_bg	根據提示詞替換影像背景	是
picsart_enhance	升級 / 增強影像	是
picsart_vectorize	將點陣影像轉換為 SVG	是
picsart_music_studio	開啟 Music Studio（音樂 / 音效 / 專輯封面）	否¹

¹ 開啟工作室免費；在裡面生成會消耗點數。

目錄與成本

工具	用途	消耗點數
picsart_list_models	模型選擇器小工具 — 供使用者視覺化瀏覽	否
picsart_model_catalog	相同的目錄，以純資料形式提供，供代理程式自行推理	否
picsart_model_params	單一模型的參數結構（型別、必填、列舉、最小值/最大值）	否
picsart_preflight	驗證參數負載並報價其點數成本 — 一次免費試跑	否
picsart_credits	目前點數餘額和配額明細	否
picsart_job_status	輪詢由 picsart_generate 以 async: true 啟動的工作	否

Drive

工具	用途	消耗點數
picsart_drive	Picsart Drive 的單一入口點 — 行為由 action 選擇	否

picsart_drive 接受 action 參數；沒有獨立的逐操作 Drive 工具：

action	功能說明
list	瀏覽資料夾（省略 folderUid = 根目錄；flat: true 列出每個檔案）
create_folder	建立資料夾（name，可選的父層 folderUid，description）
upload	儲存檔案 — 可以是 file（聊天附件）或 url + name（HTTPS URL 或內嵌 data: URI）。result.url 是可直接傳遞給 imageUrls 的 CDN URL
move	將 itemUids 移動到 targetFolderUid
delete	將 itemUids 軟刪除到垃圾桶（permanent: true 可永久刪除）
update	在單一檔案上設定自訂屬性（itemUid + attributes）

每個操作都會傳回目前的資料夾清單，以便 Drive 小工具可以渲染。詳細資訊請參閱 檔案與 Drive，以及 本機檔案 → URL 了解如何先將檔案從磁碟取出。

沒有工具接受檔案系統路徑

每個影像/影片輸入都是 URL。MCP 合約中沒有任何地方有 filePath 參數 — 請參閱 本機檔案 → URL 了解實際可行的三種方式。

建議的生成流程

這些工具設計為可串聯使用。此順序可避免意外：

1. picsart_model_catalog（或 picsart_list_models 讓使用者視覺化選擇）→ 選擇模型
2. picsart_model_params → 了解其輸入
3. picsart_preflight → 驗證負載並在一次免費呼叫中報價成本
4. picsart_generate → 實際執行

如果您手上已有模型 ID，可直接跳到 picsart_generate。

範例工具呼叫

生成影像：

{
  "name": "picsart_generate",
  "arguments": {
    "model": "flux-2-pro",
    "prompt": "a ceramic cup, studio lighting, 4:3",
    "aspectRatio": "4:3",
    "count": 1
  }
}

生成影片：

{
  "name": "picsart_generate",
  "arguments": {
    "model": "seedance-2.0",
    "prompt": "a cat skiing down a mountain",
    "duration": 8,
    "aspectRatio": "16:9",
    "generateAudio": true
  }
}

先驗證並報價成本：

{
  "name": "picsart_preflight",
  "arguments": {
    "model": "veo-3.1",
    "params": { "prompt": "a drone shot over a snowy ridge", "duration": 8, "resolution": "1080p" }
  }
}

移除背景：

{
  "name": "picsart_remove_bg",
  "arguments": {
    "imageUrls": ["https://example.com/product.jpg"]
  }
}

輸入參考

picsart_generate 接受：

• 必填： model（模型 ID）、prompt（文字提示詞）
• 常見選用： aspectRatio、resolution、duration、count（1 到 8）、quality、style、negativePrompt
• 影像輸入： imageUrls（URL 陣列 — 用於影像到影像或影像到影片模型）
• 影片輸入： videoUrl（單一 URL — 用於影片到影片模型）
• 音訊生成： generateAudio（布林值 — 用於支援原生音訊的影片模型）
• 提示詞增強： enhancePrompt（布林值 — 生成前會先透過 LLM 處理）
• 模型特定參數： extra（自由格式物件 — 使用 picsart_model_params 查看模型接受哪些參數）

結果以 results: [{ url, metadata? }] 形式回傳。資產是 URL，絕不是 base64。每個結果也包含 resource_link，以便代理程式在後續工具呼叫中引用它。

常見問題

MCP 伺服器需要單獨的 API 金鑰嗎？

不需要。它使用與 CLI 相同的 OAuth 工作階段。執行 gen-ai login 一次；MCP 伺服器會自動取得這些憑證。

我可以同時在同一台機器上使用 MCP 和 CLI 嗎？

可以。兩者使用相同的憑證檔（~/.gen-ai/credentials.json）和相同的點數餘額。平行執行沒有問題。

代理程式已連接，但工具沒有出現。

新增 MCP 設定後請重新啟動代理程式。大多數代理程式在啟動時載入工具清單，而非動態載入。

哪些模型可以透過 MCP 使用？

目錄中全部 201 個模型。沒有 MCP 專屬的子集。使用 picsart_list_models 依模式或供應商篩選，或瀏覽 模型目錄。

代理程式可以將生成的檔案儲存到 Drive 嗎？

可以。在 picsart_generate 參數中傳遞 "saveToDrive": true，或使用 picsart_drive 上傳本機檔案或 URL。請參閱 檔案與 Drive。

我怎麼知道執行模型前需要多少成本？

使用模型 ID 和您計畫使用的參數呼叫 picsart_preflight。它會驗證負載並回傳點數估算，而不會執行生成。

如果我的點數餘額在生成中途用完會怎樣？

使用 picsart_credits 檢查餘額，並在重試前到 picsart.com 儲值。