Cloudinary MCP Server

Cloudinary MCP サーバー

この 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 > Settings > Developer > Edit Config

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 Console の 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 Console から認証情報を取得します：

   • Cloud Name
   • API Key
   • API Secret

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 デスクトップアプリでは、お使いの OS に応じた適切な場所にある設定ファイルを編集します。

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"
  }
});