Cloudinary

npx add-mcp 'https://asset-management.mcp.cloudinary.com/mcp'

Серверы Cloudinary MCP

Model Context Protocol (MCP) — это новый стандартизированный протокол для управления контекстом между большими языковыми моделями (LLM) и внешними системами. Этот репозиторий предоставляет комплексные MCP-серверы для платформы управления медиа Cloudinary, позволяя использовать естественный язык для загрузки, трансформации, анализа и организации ваших медиаресурсов непосредственно из AI-приложений, таких как Cursor и Claude.

С помощью этих MCP-серверов вы можете seamlessly управлять всем вашим медиа-процессом через разговорный AI — от загрузки и трансформации изображений и видео до настройки автоматизированных конвейеров обработки, анализа контента с помощью инструментов на базе AI и организации ресурсов с помощью структурированных метаданных. Создаете ли вы медиа-насыщенные приложения, управляете большими библиотеками ресурсов или автоматизируете контент-процессы, эти серверы предоставляют прямой доступ к полному набору возможностей оптимизации и управления медиа Cloudinary.

Доступны следующие MCP-серверы для Cloudinary:

Имя сервера	Описание	Удаленный MCP-сервер
Управление ресурсами	Загружайте, управляйте и трансформируйте ваши медиаресурсы с расширенными возможностями поиска и организации	asset-management
Конфигурация окружения	Настраивайте и управляйте параметрами окружения Cloudinary, пресетами загрузки и трансформациями	environment-config
Структурированные метаданные	Создавайте, управляйте и запрашивайте поля структурированных метаданных для улучшенной организации ресурсов и поиска	structured-metadata
Анализ	Используйте возможности анализа контента, модерации и автоматической разметки на базе AI для ваших медиаресурсов	analysis
MediaFlows	Создавайте и управляйте low-code автоматизациями рабочих процессов для изображений и видео с помощью AI-ассистента	mediaflows

Содержание

• Документация
• Установка
  • Удаленные MCP-серверы (рекомендуется)
  • Локальные MCP-серверы
  • Docker-образы
• Примеры конфигурации
  • Расширенная конфигурация локального сервера
• Аутентификация
• Возможности по серверам
• Нужен доступ к дополнительным инструментам Cloudinary?
• Устранение неполадок
• Платные функции
• Лицензия

Документация

Для подробных руководств, учебных пособий и исчерпывающей документации по использованию MCP-серверов Cloudinary:

• Документация Cloudinary MCP и LLM-инструментов — Полное руководство по интеграции Cloudinary с AI/LLM-приложениями
• Документация MediaFlows MCP — Инструкции по настройке и рекомендации по использованию сервера MediaFlows (MCP)

Установка

Удаленные MCP-серверы (рекомендуется)

Удаленные MCP-серверы размещаются Cloudinary и готовы к использованию немедленно. Локальная установка не требуется.

Локальные MCP-серверы

Локальные MCP-серверы запускаются на вашем компьютере с использованием npm-пакетов. Выберите этот вариант, если вам нужен больший контроль или кастомизация.

Примечание: После установки вам потребуется настроить переменные окружения (CLOUDINARY_CLOUD_NAME, CLOUDINARY_API_KEY, CLOUDINARY_API_SECRET) с вашими реальными учетными данными.

Docker-образы

Официальные Docker-образы для MCP-серверов Cloudinary доступны на Docker Hub, предоставляя вариант контейнерного развертывания для запуска MCP-серверов локально или в облачных средах.

Доступно на Docker Hub: Docker-образы Cloudinary MCP

Docker-образы предлагают несколько преимуществ:

• Изолированные среды — Запускайте MCP-серверы в контейнерах, не затрагивая системные зависимости
• Простое развертывание — Быстрая настройка с минимальной конфигурацией
• Консистентная среда выполнения — Обеспечивает одинаковую среду на разных машинах и платформах
• Масштабируемость — Легко развертывайте несколько экземпляров или интегрируйте в системы оркестрации контейнеров

Для использования Docker-образов убедитесь, что Docker установлен на вашей системе, и передайте учетные данные Cloudinary как переменные окружения при запуске контейнеров. См. документацию по конкретному Docker-образу на Docker Hub для получения инструкций по использованию.

Примеры конфигурации

Конфигурация удаленных MCP-серверов

Удаленные серверы размещаются Cloudinary и доступны по URL:

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp"
    },
    "cloudinary-env-config-remote": {
      "url": "https://environment-config.mcp.cloudinary.com/mcp"
    },
    "cloudinary-smd-remote": {
      "url": "https://structured-metadata.mcp.cloudinary.com/mcp"
    },
    "cloudinary-analysis-remote": {
      "url": "https://analysis.mcp.cloudinary.com/sse"
    },
    "mediaflows": {
      "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp"
    }
  }
}

Транспорт: Удаленные серверы поддерживают две конечные точки — /mcp (Streamable HTTP, рекомендуется, без сохранения состояния) и /sse (SSE, устаревшая, сохранена для обратной совместимости). Конечная точка /sse также принимает POST-запросы как псевдоним для /mcp, поэтому клиенты, отправляющие Streamable HTTP на /sse, будут работать. Используйте /mcp для новых конфигураций.

Удаленные MCP-серверы с аутентификацией

Удаленные MCP-серверы, размещаемые Cloudinary, по умолчанию используют OAuth2 для аутентификации. Вы также можете аутентифицироваться с помощью API-ключей через заголовки:

Использование CLOUDINARY_URL (самый простой способ)

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name"
      }
    }
  }
}

Использование отдельных заголовков

{
  "mcpServers": {
    "cloudinary-env-config-remote": {
      "url": "https://environment-config.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-cloud-name": "your_cloud_name",
        "cloudinary-api-key": "your_api_key",
        "cloudinary-api-secret": "your_api_secret"
      }
    }
  }
}

С пользовательской конфигурацией

{
  "mcpServers": {
    "cloudinary-smd-remote": {
      "url": "https://structured-metadata.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name",
        "cloudinary-region": "api-eu",
        "cloudinary-tools": "list-metadata-fields,get-metadata-field,create-metadata-field"
      }
    }
  }
}

С отладочными заголовками

Чтобы отображать заголовки ограничения скорости API и идентификаторы запросов в результатах инструментов, включите встраивание заголовков:

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name",
        "cloudinary-embed-headers": "true"
      }
    }
  }
}

Каждый результат инструмента будет включать поле _headers с информацией об ограничении скорости и трассировке запросов:

{
  "_headers": {
    "x-featureratelimit-limit": "10000",
    "x-featureratelimit-remaining": "9998",
    "x-featureratelimit-reset": "Thu, 13 Feb 2026 00:00:00 GMT",
    "x-request-id": "bfeaccc60050594832508590a358a1a4"
  }
}

Конфигурация локальных MCP-серверов

Локальные серверы запускаются на вашем компьютере с использованием npm-пакетов:

Вариант 1: Использование переменной окружения CLOUDINARY_URL (рекомендуется)

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/asset-management-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-env-config": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/environment-config-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-smd": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/structured-metadata-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-analysis": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/analysis", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    }
  }
}

Вариант 2: Использование отдельных переменных окружения

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/asset-management-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "cloud_name",
        "CLOUDINARY_API_KEY": "api_key",
        "CLOUDINARY_API_SECRET": "api_secret"
      }
    }
  }
}

Вариант 3: Использование аргументов командной строки

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": [
        "-y", "--package", "@cloudinary/asset-management-mcp",
        "--",
        "mcp", "start",
        "--cloud-name", "cloud_name",
        "--api-key", "api_key",
        "--api-secret", "api_secret"
      ]
    }
  }
}

Конфигурация сервера MediaFlows MCP

Для MediaFlows используйте следующую конфигурацию:

{
  "mcpServers": {
    "mediaflows": {
      "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp",
      "headers": {
        "cld-cloud-name": "cloud_name",
        "cld-api-key": "api_key",
        "cld-secret": "api_secret"
      }
    }
  }
}

Расширенная конфигурация локального сервера

Каждый npm-пакет поддерживает дополнительные параметры конфигурации помимо базовых примеров настройки выше.

Запуск как SSE-сервер

Для запуска локального MCP-сервера с использованием транспорта Server-Sent Events (SSE) вместо stdio:

npx -y --package @cloudinary/asset-management-mcp -- mcp start --transport sse

Вы можете указать пользовательский порт (по умолчанию 2718):

npx -y --package @cloudinary/asset-management-mcp -- mcp start --transport sse --port 3000

Доступные параметры конфигурации

Чтобы увидеть все доступные параметры конфигурации для любого пакета:

npx -y --package @cloudinary/asset-management-mcp -- mcp start --help

Полный список доступных флагов:

USAGE
  mcp start [--transport stdio|sse] [--port value] [--tool value]...
            [--scope admin|builder|librarian] [--api-key value]
            [--api-secret value] [--oauth2 value] [--cloud-name value]
            [--server-url value] [--server-index value]
            [--region api|api-eu|api-ap] [--api-host value]
            [--log-level debug|warning|info|error] [--env value]...

FLAGS
  --transport       The transport to use for communicating with the server
                    [stdio|sse, default = stdio]
  --port            The port to use when the SSE transport is enabled
                    [default = 2718]
  --tool...         Specify tools to mount on the server (repeatable)
  --scope           Mount tools/resources that match given scope
                    [admin|builder|librarian]
  --api-key         Sets the apiKey auth field for the API
  --api-secret      Sets the apiSecret auth field for the API
  --oauth2          Sets the oauth2 auth field for the API
  --cloud-name      Allows setting the cloudName parameter for all operations
  --server-url      Overrides the default server URL used by the SDK
  --server-index    Selects a predefined server used by the SDK
  --region          Sets the region variable for url substitution
                    [api|api-eu|api-ap]
  --api-host        Sets the host variable for url substitution
  --log-level       The log level to use for the server
                    [debug|warning|info|error, default = info]
  --env...          Environment variables made available to the server
  -h, --help        Print help information and exit

Отладка

Для детальной отладки сетевых полезных нагрузок используйте переменную окружения CLOUDINARY_DEBUG:

CLOUDINARY_DEBUG=true npx -y --package @cloudinary/asset-management-mcp -- mcp start

Вы можете комбинировать режим отладки с другими параметрами для всестороннего устранения неполадок:

CLOUDINARY_DEBUG=true npx -y --package @cloudinary/asset-management-mcp -- mcp start --transport sse --log-level debug

Примечание: Эти параметры конфигурации применяются ко всем локальным MCP-пакетам:

• @cloudinary/asset-management-mcp
• @cloudinary/environment-config-mcp
• @cloudinary/structured-metadata-mcp
• @cloudinary/analysis

Аутентификация

При локальном запуске MCP-серверов аутентификация может быть настроена несколькими способами:

Вариант 1: Отдельные переменные окружения (рекомендуется)

export CLOUDINARY_CLOUD_NAME="cloud_name"
export CLOUDINARY_API_KEY="api_key"
export CLOUDINARY_API_SECRET="api_secret"

Вариант 2: Переменная окружения CLOUDINARY_URL

export CLOUDINARY_URL="cloudinary://api_key:api_secret@cloud_name"

Вариант 3: Аргументы командной строки

Передавайте учетные данные напрямую как аргументы (см. примеры конфигурации выше)

Вы можете найти свои учетные данные Cloudinary в панели управления Cloudinary Console в разделе Настройки > Безопасность.

Возможности по серверам

Сервер управления ресурсами

• Загрузка и управление медиаресурсами (изображения, видео, необработанные файлы)
• Поиск и организация ресурсов с расширенными возможностями фильтрации
• Обработка операций с ресурсами и трансформаций
• Управление папками, тегами и связями ресурсов
• Создание архивов и ссылок для скачивания

Сервер конфигурации окружения

• Настройка пресетов загрузки и параметров трансформации
• Управление профилями потоковой передачи и вебхук-уведомлениями
• Настройка сопоставлений загрузки

Сервер структурированных метаданных

• Создание и управление полями структурированных метаданных
• Настройка условных правил метаданных и валидации
• Организация и поиск конфигураций метаданных
• Обработка связей полей метаданных и их порядка

Сервер анализа

• Анализ контента на базе AI, включая разметку, модерацию и создание подписей
• Обнаружение и распознавание объектов с помощью нескольких AI-моделей
• Анализ качества изображений и обнаружение водяных знаков
• Модерация контента и анализ безопасности
• Возможности обнаружения моды, текста и анатомии

Сервер MediaFlows

• Создание и управление автоматизациями рабочих процессов с использованием естественного языка
• Запрос существующих автоматизаций PowerFlow в вашем окружении
• Создание условной логики на основе метаданных, тегов и свойств ресурсов
• Автоматизация рабочих процессов модерации, утверждения и уведомлений ресурсов
• Отладка и понимание существующих конфигураций автоматизаций

Нужен доступ к дополнительным инструментам Cloudinary?

Мы продолжаем добавлять новые функции в эти MCP-серверы. Если вы хотите оставить отзыв, сообщить об ошибке или предложить новую функцию, пожалуйста, создайте issue в этом репозитории.

Устранение неполадок

«Ответ Claude был прерван...»

Если вы видите это сообщение, Claude, вероятно, достиг лимита длины контекста и остановился на середине ответа. Это чаще всего происходит на серверах, которые запускают множество цепочек вызовов инструментов, например, сервер управления ресурсами с большими списками ресурсов.

Чтобы снизить вероятность возникновения этой проблемы:

• Старайтесь быть конкретными и краткими в запросах.
• Если один запрос вызывает несколько инструментов, попробуйте разбить его на несколько меньших вызовов инструментов, чтобы ответы были короткими.
• Используйте параметры фильтрации для ограничения области поиска и списков ресурсов.

Проблемы с аутентификацией

Убедитесь, что ваши учетные данные Cloudinary настроены правильно и имеют необходимые разрешения для операций, которые вы пытаетесь выполнить.

Платные функции

Некоторые функции могут требовать платного плана Cloudinary. Убедитесь, что ваш аккаунт Cloudinary имеет необходимый уровень подписки для функций, которые вы собираетесь использовать, например:

• Расширенные функции AI-анализа
• Высокообъемное использование API
• Расширенные возможности трансформации

Лицензия

Лицензировано по лицензии MIT. См. файл LICENSE для получения подробной информации.