Cloudinary MCP Server

🚀 Cloudinary MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）サーバーであり、AIアシスタントを通じてCloudinaryのアップロードおよび管理APIメソッドをツールとして公開します。この統合により、AIシステムはCloudinaryクラウドとのやり取りをトリガーできます。

🚀 クイックスタート

仕組み

このMCPサーバーは以下のことを行います。

• Cloudinary APIを代行で呼び出します。
• AIアシスタントがCloudinaryにファイルをアップロードできるようにします。
• Cloudinaryクラウドリソースの管理を可能にします。

これらの操作は、CloudinaryのAPIに依存して実行されます。ただし、すべてのメソッドとパラメータがサポートされているわけではなく、今後さらに機能が追加される予定です。特定のメソッドが必要な場合は、問題にリクエストを提出してください。

利点

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

✨ 主な機能

Claude Desktopの使用方法

前提条件

• NodeJS
• MCPクライアント（Claude Desktop Appなど）
• APIキーで作成し、コピーしたCloudinary API Key/Secret

インストール

このサーバーをClaude Desktopアプリケーションとともに使用するには、claude_desktop_config.jsonの「mcpServers」セクションに以下の設定を追加してください。

{
    "mcpServers": {
        "cloudinary-mcp-server": {
            "command": "npx",
            "args": ["-y", "cloudinary-mcp-server"],
            "env": {
                "CLOUDINARY_CLOUD_NAME": "<クラウド名>",
                "CLOUDINARY_API_KEY": "<APIキー>",
                "CLOUDINARY_API_SECRET": "<APIキー>"
            }
        }
    }
}

• CLOUDINARY_CLOUD_NAME - あなたのクラウド名
• CLOUDINARY_API_KEY - あなたのCloudinary APIキー
• CLOUDINARY_API_SECRET - あなたのCloudinary APIキー

ツール

以下のツールが利用可能です。

1. アップロード

   • 説明：ファイル（アセット）をCloudinaryにアップロードします。
   • パラメータ：
     • source: URL、ファイルパス、Base64コンテンツまたはアップロードするバイナリデータ
     • folder: オプションのCloudinaryフォルダパス
     • publicId: オプションのアップロードファイルのパブリックID
     • resourceType: アップロードするリソースのタイプ（画像、動画、オリジナル、自動）
     • tags: アセットに割り当てるためのカンマ区切りのタグリスト

2. アセットの削除

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

3. アセットの取得

   • 説明：指定されたファイル（アセット）の詳細情報を取得します。
   • パラメータ：
     • assetId: CloudinaryアセットID
     • publicId: アセットのパブリックID
     • resourceType: リソースのタイプ（画像、オリジナル、動画）
     • type: 配信タイプ（アップロード、プライベート、認証済みなど）
     • tags: タグ名のリストを含めるかどうか
     • context: コンテキストメタデータを含めるかどうか
     • metadata: 構造化メタデータを含めるかどうか

4. アセットの検索

   • 説明：クエリ式を使用してCloudinary内の既存のファイル（アセット）を検索します。
   • パラメータ：
     • expression: 検索式（例：'タグ=猫'または'public_id:folder/*'）
     • resourceType: リソースのタイプ（画像、オリジナル、動画）
     • maxResults: 結果の最大数
     • nextCursor: ページング用のカーソル

5. 使用状況の取得

   • 説明：あなたの製品環境の使用状況の詳細情報を取得します。これには、ストレージ、クレジット、帯域幅、リクエスト、リソース数、および追加機能の使用状況が含まれます。
   • パラメータ：
     • date: オプション。yyyy-mm-dd形式の日付の使用状況レポート。過去3か月以内である必要があります。デフォルト値：現在の日付