Cloudinary

🚀 Cloudinary MCP 服務器

此 MCP 服務器為通過 Claude Desktop 及兼容的 MCP 客戶端將圖像和視頻上傳到 Cloudinary 提供工具，助力用戶便捷地完成相關操作。

點擊此處

🚀 快速開始

此 MCP 服務器可讓你藉助 Claude Desktop 及兼容的 MCP 客戶端，輕鬆將圖像和視頻上傳至 Cloudinary。

📦 安裝指南

先決條件：Node.js

1. 從 nodejs.org 安裝 Node.js（版本 18 或更高）和 npm。
2. 驗證安裝：

node --version
npm --version

使用 npx 安裝（推薦）

1. 導航到 Claude 配置目錄：

   • Windows: C:\Users\NAME\AppData\Roaming\Claude
   • macOS: ~/Library/Application Support/Claude/

   你也可以在 Claude Desktop 應用中找到這些路徑：Claude Desktop > 設置 > 開發人員 > 編輯配置。

2. 在你的 MCP 設置文件中添加以下配置：

{
  "mcpServers": {
    "cloudinary": {
      "command": "npx",
      "args": ["@felores/cloudinary-mcp-server@latest"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret"
      }
    }
  }
}

3. 確保將環境變量替換為從 Cloudinary 控制檯 獲取的實際 Cloudinary 憑據。

開發者安裝

如果你想要修改服務器或進行開發貢獻：

1. 克隆倉庫：

git clone https://github.com/felores/cloudinary-mcp-server.git
cd cloudinary-mcp-server

2. 安裝依賴項並構建：

npm install
npm run build

📚 詳細文檔

設置說明

1. 首先確保你擁有 Cloudinary 賬戶，並從 Cloudinary 控制檯 獲取你的憑證：
   • 雲名稱
   • API 密鑰
   • API 秘密
2. 將服務器配置添加到 Claude/Cline MCP 設置文件中：

{
  "mcpServers": {
    "cloudinary": {
      "command": "node",
      "args": ["c:/path/to/cloudinary-mcp-server/dist/index.js"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret"
      }
    }
  }
}

對於 Claude 桌面應用程序，編輯相應位置的配置文件。 3. 安裝依賴項並構建服務器：

npm install
npm run build

可用工具

upload

上傳圖像和視頻到 Cloudinary。 參數:

• file（必需）：要上傳的文件路徑、URL 或 base64 數據 URI
• resource_type（可選）：資源類型 ('image', 'video' 或 'raw')
• public_id（可選）：上傳資產的自定義公共 ID
• overwrite（可選）：是否覆蓋具有相同公共 ID 的現有資產
• tags（可選）：要分配給上傳資產的標籤數組

示例在 Claude/Cline 中使用：

use_mcp_tool({
  server_name: "cloudinary",
  tool_name: "upload",
  arguments: {
    file: "path/to/image.jpg",
    resource_type: "image",
    public_id: "my-custom-id"
  }
});