Cloudinary

🚀 Cloudinary MCP サーバー

この MCP サーバーは、Claude Desktop および互換性のある MCP クライアントを通じて、画像と動画を Cloudinary にアップロードするためのツールを提供します。

🚀 クイックスタート

この 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 > 設定 > 開発者 > 設定を編集

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 コンソール から取得した実際の 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 コンソール から以下の資格情報を取得します：

   • クラウド名
   • API キー
   • API シークレット

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 デスクトップアプリケーションの場合は、該当する場所の設定ファイルを編集します。

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