Cloudinary MCP Server

🚀 Cloudinary MCP 服務器

Cloudinary MCP 服務器是一個模型上下文協議服務器，它藉助 AI 助手將 Cloudinary 的上傳和管理 API 方法以工具的形式公開。這種集成方式讓 AI 系統能夠觸發並與您的 Cloudinary 雲進行交互，為您的雲操作和資源管理帶來了新的便利。

🚀 快速開始

工作原理

該 MCP 服務器主要負責代表您調用 Cloudinary API，具體功能如下：

• 允許 AI 助手上傳文件到 Cloudinary。
• 支持對您的 Cloudinary 雲資源進行管理。

不過，它依賴於 Cloudinary 的 API 來執行這些操作，目前並非所有方法和參數都受支持，後續會逐步添加更多功能。如果您需要特定的方法，請在 問題 中提交請求。

優勢

• 將您的 Cloudinary 雲操作轉化為 AI 助手的可調用工具，讓操作更加便捷。
• 把您的 Cloudinary 資源轉化為供 AI 助手使用的數據，提升資源利用率。

📦 安裝指南

使用 Claude Desktop

先決條件

• NodeJS
• MCP 客戶端（如 Claude Desktop App）
• 在 API 密鑰 處創建並複製 Cloudinary API Key/Secret

安裝步驟

要與 Claude Desktop 應用程序一起使用此服務器，請在 claude_desktop_config.json 的“mcpServers”部分添加以下配置：

{
    "mcpServers": {
        "cloudinary-mcp-server": {
            "command": "npx",
            "args": ["-y", "cloudinary-mcp-server"],
            "env": {
                "CLOUDINARY_CLOUD_NAME": "<雲名稱>",
                "CLOUDINARY_API_KEY": "<API密鑰>",
                "CLOUDINARY_API_SECRET": "<API密鑰>"
            }
        }
    }
}

• CLOUDINARY_CLOUD_NAME - 您的雲名稱
• CLOUDINARY_API_KEY - 您的 Cloudinary API 密鑰
• CLOUDINARY_API_SECRET - 您的 Cloudinary API 密鑰

💻 使用示例

工具介紹

以下是該服務器提供的可用工具：

1. 上傳

   • 描述：將文件（資產）上傳到 Cloudinary。
   • 參數：
     • source: URL、文件路徑、Base64 內容或要上傳的二進制數據。
     • folder: 可選的 Cloudinary 文件夾路徑。
     • publicId: 可選的上傳文件的公共 ID。
     • resourceType: 要上傳資源的類型（圖像、視頻、原始、自動）。
     • tags: 以逗號分隔的標籤列表，用於分配到資產。

2. 刪除資產

   • 描述：從 Cloudinary 中刪除特定文件（資產）。
   • 參數：
     • publicId: 要刪除的資產的公共 ID。
     • assetId: 要刪除的資產的資產 ID。

3. 獲取資產

   • 描述：獲取指定文件（資產）的詳細信息。
   • 參數：
     • assetId: Cloudinary 資產 ID。
     • publicId: 資產的公共 ID。
     • resourceType: 資源類型（圖像、原始、視頻）。
     • type: 交付類型（上傳、私有、經過身份驗證等）。
     • tags: 是否包括標籤名稱列表。
     • context: 是否包含上下文元數據。
     • metadata: 是否包含結構化元數據。

4. 查找資產

   • 描述：使用查詢表達式在 Cloudinary 中搜索現有文件（資產）。
   • 參數：
     • expression: 搜索表達式（例如'標籤=貓'或'public_id:folder/*'）。
     • resourceType: 資源類型（圖像、原始、視頻）。
     • maxResults: 結果的最大數量。
     • nextCursor: 用於分頁的遊標。

5. 獲取使用情況

   • 描述：獲取您的產品環境使用的詳細信息，包括存儲、積分、帶寬、請求、資源數量和附加功能使用情況。
   • 參數：
     • date: 可選。日期格式為 yyyy - mm - dd 的使用情況報告。必須在過去的 3 個月內。默認值：當前日期。