Cloudinary MCP サーバー

Cloudinaryのアップロードおよび管理APIメソッドをAIアシスタントのツールとして公開するモデルコンテキストプロトコルサーバー。この統合により、AIシステムがCloudinaryクラウドをトリガーし、操作できるようになります。

仕組み

MCP サーバー:

• Cloudinary API をあなたに代わって呼び出します

• Cloudinaryへのアセットのアップロードを可能にする

• Cloudinaryクラウド内の資産管理を可能にします

これらのアクションを実行するにはCloudinary APIが必要です。すべてのメソッドとパラメータがサポートされているわけではありません。今後、さらに多くのメソッドとパラメータが追加される予定です。

必要な場合は、特定のメソッドのリクエストを記載した問題を開いてください。

利点

• Cloudinary のクラウドアクションを AI アシスタントの呼び出し可能なツールに変換します

• Cloudinary の資産を AI アシスタントのデータに変換します

Claude Desktopでの使用

前提条件

• ノードJS

• MCP クライアント (Claude デスクトップ アプリなど)

• Cloudinary APIキー/シークレットを作成＆コピー: API KEYS

インストール

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

• CLOUDINARY_CLOUD_NAME - クラウド名

• CLOUDINARY_API_KEY - クラウドのAPIキー

• CLOUDINARY_API_SECRET - クラウドのAPIシークレット

ツール

利用可能なツールは次のとおりです。

1. アップロード

   • 説明: Cloudinaryにファイル（アセット）をアップロードする

   • パラメータ:

     • source : アップロードする URL、ファイル パス、base64 コンテンツ、またはバイナリ データ

     • folder : Cloudinaryのオプションのフォルダパス

     • publicId : アップロードされたアセットのオプションの公開ID

     • resourceType : アップロードするリソースの種類 (image、video、raw、auto)

     • tags : アセットに割り当てるタグのカンマ区切りリスト

2. 資産の削除

   • 説明: Cloudinaryからファイル（アセット）を削除します

   • パラメータ:

     • publicId : 削除するアセットのパブリックID

     • assetId : 削除するアセットのアセットID

3. 資産取得

   • 説明: 特定のファイル（アセット）の詳細を取得します

   • パラメータ:

     • assetId : CloudinaryアセットID

     • publicId : アセットのパブリックID

     • resourceType : アセットの種類（画像、raw、ビデオ）

     • type : 配信タイプ（アップロード、プライベート、認証済みなど）

     • tags : タグ名のリストを含めるかどうか

     • context : コンテキストメタデータを含めるかどうか

     • metadata :構造化メタデータを含めるかどうか

4. 資産を見つける

   • 説明: クエリ式を使用して Cloudinary 内の既存のファイル (アセット) を検索します

   • パラメータ:

     • expression : 検索式（例: 'tags=cat' または 'public_id:folder/*'）

     • resourceType : リソースタイプ（画像、ビデオ、raw）

     • maxResults : 結果の最大数（1～500）

     • nextCursor : ページ区切りの次のカーソル

     • tags : レスポンスにタグを含める

     • context : レスポンスにコンテキストを含める

5. 使用状況を取得する

   • 説明: ストレージ、クレジット、帯域幅、リクエスト、リソース数、アドオンの使用状況など、製品環境の使用状況に関するレポートを取得します。

   • パラメータ:

     • date : オプション。使用状況レポートの日付をyyyy-mm-dd形式で指定します。過去3か月以内である必要があります。デフォルト: 現在の日付