Canva MCP Server

🚀 Canva API MCP 服務器

Canva API MCP 服務器是一個全面的 Model Context Protocol (MCP) 服務器，可用於與 Canva 的 API 進行交互。它提供了一系列工具和資源，方便用戶管理設計、品牌、資產和用戶等內容。

🚀 快速開始

若要啟動 Canva API MCP 服務器，可按以下步驟操作：

1. 克隆此倉庫。
2. 安裝依賴項：

   npm install
   

3. 複製 .env.example 到 .env 並添加您的 Canva API 憑證：

   CANVA_APP_ID=your_app_id
   CANVA_API_KEY=your_api_key
   

4. 啟動服務器：

   npm run dev
   

✨ 主要特性

• 全面覆蓋 Canva API 端點，提供完整的 API 交互支持。
• 提供所有主要 API 操作的工具，滿足多樣化的使用需求。
• 提供文檔和技術細節等資源，方便用戶深入瞭解和使用。
• 支持測試使用的模擬數據，便於測試和開發工作。

💻 使用示例

使用 MCP Inspector 進行測試

要使用 MCP Inspector 測試服務器，可執行以下命令：

npm run inspect

執行該命令後，將打開一個網絡界面，您可以在其中：

• 檢查和測試所有可用工具。
• 訪問資源。
• 查看服務器日誌。

🔧 技術細節

可用工具

設計管理

• get_design - 獲取特定設計的信息。
• list_designs - 列出設計，可選分頁。

品牌管理

• get_brand - 獲取特定品牌的信息。
• list_brands - 列出品牌，可選分頁。

資產管理

• get_asset - 獲取特定資產的信息。
• list_assets - 列出資產，可選過濾和分頁。
• upload_image - 從 URL 上載圖像到 Canva。

用戶管理

• get_user - 獲取特定用戶的信息。
• list_users - 列出用戶，可選分頁。

可用資源

文檔

• canva://overview - API 的總體概述。
• canva://getting-started - 入門指南。
• canva://authentication - 身份驗證信息。
• canva://designs - 設計 API 文檔。
• canva://brands - 品牌 API 文檔。
• canva://assets - 資產 API 文檔。
• canva://users - 用戶 API 文檔。

實體資源

• canva://design/{designId} - 特定設計的信息。
• canva://brand/{brandId} - 特定品牌的信息。
• canva://asset/{assetId} - 特定資產的信息。

模擬數據

如果沒有提供 API 憑證，服務器將使用模擬數據進行所有響應。這對於測試和開發非常有用。

📄 許可證

本項目採用 MIT 許可證。