Cloudinary MCP Server

Cloudinary MCP サーバー

Cloudinary の Upload API と Admin API のメソッドを、AI アシスタント向けのツールとして公開する Model Context Protocol サーバーです。 この統合により、AI システムは Cloudinary クラウドでの操作を実行し、クラウドとやり取りできます。

仕組み

MCP サーバーは次の機能を提供します。

• Cloudinary API の呼び出しを代行します
• Cloudinary へのアセットのアップロードを可能にします
• Cloudinary クラウド内のアセット管理を可能にします

これらの操作は、Cloudinary の API を利用して実行します。すべてのメソッドとパラメーターがサポートされているわけではありません。 今後、順次追加される予定です。

特定のメソッドが必要な場合は、リクエストを添えてissueを作成してください。

メリット

• Cloudinary クラウドでの操作を、AI アシスタントから呼び出せるツールに変換します
• Cloudinary のアセットを、AI アシスタントが利用できるデータに変換します

Claude Desktop での使用方法

前提条件

• NodeJS
• MCP クライアント（Claude Desktop App など）
• Cloudinary API キーとシークレットを作成してコピーします：API KEYS

インストール

Claude Desktop アプリでこのサーバーを使用するには、次の設定を claude_desktop_config.json の「mcpServers」セクションに追加します。

{
    "mcpServers": {
        "cloudinary-mcp-server": {
            "command": "npx",
            "args": ["-y", "cloudinary-mcp-server"],
            "env": {
                "CLOUDINARY_CLOUD_NAME": "<cloud name>",
                "CLOUDINARY_API_KEY": "<api-key>",
                "CLOUDINARY_API_SECRET": "<api-secret>"
            }
        }
    }
}

• CLOUDINARY_CLOUD_NAME - クラウド名
• CLOUDINARY_API_KEY - クラウドの API キー
• CLOUDINARY_API_SECRET - クラウドの API シークレット

ツール

以下のツールを利用できます。

1. upload

   • 説明：Cloudinary にファイル（アセット）をアップロードします
   • パラメーター：
     • source：アップロードする URL、ファイルパス、Base64 コンテンツ、またはバイナリデータ
     • folder：Cloudinary の任意のフォルダーパス
     • publicId：アップロードするアセットの任意のパブリック ID
     • resourceType：アップロードするリソースの種類（image、video、raw、auto）
     • tags：アセットに割り当てるタグのカンマ区切りリスト

2. delete-asset

   • 説明：Cloudinary からファイル（アセット）を削除します
   • パラメーター：
     • publicId：削除するアセットのパブリック ID
     • assetId：削除するアセットのアセット ID

3. get-asset

   • 説明：特定のファイル（アセット）の詳細を取得します
   • パラメーター：
     • assetId：Cloudinary のアセット ID
     • publicId：アセットのパブリック ID
     • resourceType：アセットの種類（image、raw、video）
     • type：配信タイプ（upload、private、authenticated など）
     • tags：タグ名のリストを含めるかどうか
     • context：コンテキストメタデータを含めるかどうか
     • metadata：構造化メタデータを含めるかどうか

4. find-assets

   • 説明：クエリ式を使って Cloudinary 内の既存のファイル（アセット）を検索します
   • パラメーター：
     • expression：検索式（例：'tags=cat' または 'public_id:folder/*'）
     • resourceType：リソースの種類（image、video、raw）
     • maxResults：結果の最大数（1～500）
     • nextCursor：ページネーション用の次のカーソル
     • tags：レスポンスにタグを含めます
     • context：レスポンスにコンテキストを含めます

5. get-usage

   • 説明：ストレージ、クレジット、帯域幅、リクエスト数、リソース数、アドオンの使用状況など、製品環境の使用状況レポートを取得します
   • パラメーター：
     • date：任意。yyyy-mm-dd 形式の使用状況レポートの日付です。過去 3 か月以内の日付を指定してください。デフォルト：現在の日付