cloudinary-mcp-server

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か月以内である必要があります。デフォルト: 現在の日付