Cloudinary

chính thức

Tương tác với nền tảng quản lý phương tiện của Cloudinary bằng ngôn ngữ tự nhiên.

GitHub
10
Dùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Cloudinary MCP?

  • Tải lên và quản lý tài nguyên media — Yêu cầu trợ lý của bạn tải lên hình ảnh, video hoặc tệp thô và sắp xếp chúng bằng thư mục, thẻ và mối quan hệ thông qua máy chủ Asset Management.
  • Chuyển đổi và tạo tài nguyên — Yêu cầu chuyển đổi hình ảnh và video ngay lập tức, hoặc tạo kho lưu trữ và liên kết tải xuống cho media đã chọn.
  • Cấu hình cài đặt môi trường — Sử dụng máy chủ Environment Config để thiết lập cấu hình tải lên, mặc định chuyển đổi, hồ sơ phát trực tuyến và thông báo webhook.
  • Tạo trường metadata có cấu trúc — Xác định các trường metadata tùy chỉnh với quy tắc điều kiện và xác thực để cải thiện khả năng tìm kiếm và tổ chức tài nguyên.
  • Chạy phân tích nội dung bằng AI — Tận dụng máy chủ Analysis để tự động gắn thẻ, kiểm duyệt, tạo chú thích, phát hiện đối tượng và đánh giá chất lượng hình ảnh.
  • Xây dựng quy trình tự động hóa — Sử dụng MediaFlows để tạo và quản lý các pipeline tự động hóa low-code bằng ngôn ngữ tự nhiên, bao gồm logic điều kiện và quy trình phê duyệt.

Máy chủ MCP được lưu trữ

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

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

Máy chủ MCP Cloudinary

Giao thức Ngữ cảnh Mô hình (MCP) là một giao thức mới, được chuẩn hóa để quản lý ngữ cảnh giữa các mô hình ngôn ngữ lớn (LLM) và các hệ thống bên ngoài. Kho lưu trữ này cung cấp các máy chủ MCP toàn diện cho nền tảng quản lý phương tiện của Cloudinary, cho phép bạn sử dụng ngôn ngữ tự nhiên để tải lên, chuyển đổi, phân tích và tổ chức các tài nguyên phương tiện của mình trực tiếp từ các ứng dụng AI như Cursor và Claude.

Với các máy chủ MCP này, bạn có thể quản lý toàn bộ quy trình làm việc phương tiện của mình một cách liền mạch thông qua AI hội thoại - từ tải lên và chuyển đổi hình ảnh, video, đến cấu hình các quy trình xử lý tự động, phân tích nội dung bằng các công cụ hỗ trợ AI và tổ chức tài nguyên bằng siêu dữ liệu có cấu trúc. Cho dù bạn đang xây dựng các ứng dụng giàu phương tiện, quản lý các thư viện tài nguyên lớn hay tự động hóa các quy trình làm việc nội dung, các máy chủ này cung cấp quyền truy cập trực tiếp vào bộ đầy đủ các khả năng tối ưu hóa và quản lý phương tiện của Cloudinary.

Các máy chủ MCP sau đây có sẵn cho Cloudinary:

Tên máy chủMô tảMáy chủ MCP từ xa
Quản lý tài nguyênTải lên, quản lý và chuyển đổi các tài nguyên phương tiện của bạn với khả năng tìm kiếm và tổ chức nâng caoasset-management
Cấu hình môi trườngCấu hình và quản lý cài đặt môi trường Cloudinary, cài đặt trước tải lên và các phép chuyển đổienvironment-config
Siêu dữ liệu có cấu trúcTạo, quản lý và truy vấn các trường siêu dữ liệu có cấu trúc để tăng cường tổ chức tài nguyên và khả năng tìm kiếmstructured-metadata
Phân tíchTận dụng các khả năng phân tích nội dung, kiểm duyệt và gắn thẻ tự động hỗ trợ AI cho các tài nguyên phương tiện của bạnanalysis
MediaFlowsXây dựng và quản lý các tự động hóa quy trình làm việc mã thấp cho hình ảnh và video với sự hỗ trợ của AImediaflows

Mục lục

Tài liệu

Để có hướng dẫn chi tiết, bài hướng dẫn và tài liệu toàn diện về việc sử dụng các máy chủ MCP của Cloudinary:

Cài đặt

Máy chủ MCP từ xa (Khuyến nghị)

Các máy chủ MCP từ xa được Cloudinary lưu trữ và sẵn sàng sử dụng ngay lập tức. Không cần cài đặt cục bộ.

Máy chủ MCP cục bộ

Các máy chủ MCP cục bộ chạy trên máy của bạn bằng các gói npm. Chọn tùy chọn này nếu bạn cần kiểm soát hoặc tùy chỉnh nhiều hơn.

Lưu ý: Bạn sẽ cần cấu hình các biến môi trường của mình (CLOUDINARY_CLOUD_NAME, CLOUDINARY_API_KEY, CLOUDINARY_API_SECRET) với thông tin xác thực thực tế của bạn sau khi cài đặt.

Hình ảnh Docker

Các hình ảnh Docker chính thức cho các máy chủ MCP của Cloudinary có sẵn trên Docker Hub, cung cấp tùy chọn triển khai container hóa để chạy các máy chủ MCP cục bộ hoặc trong môi trường đám mây.

Có sẵn trên Docker Hub: Hình ảnh Docker MCP Cloudinary

Hình ảnh Docker mang lại một số lợi ích:

  • Môi trường cô lập - Chạy các máy chủ MCP trong container mà không ảnh hưởng đến các phụ thuộc hệ thống của bạn
  • Triển khai dễ dàng - Thiết lập nhanh chóng với cấu hình tối thiểu
  • Thời gian chạy nhất quán - Đảm bảo cùng một môi trường trên các máy và nền tảng khác nhau
  • Khả năng mở rộng - Dễ dàng triển khai nhiều phiên bản hoặc tích hợp vào các hệ thống điều phối container

Để sử dụng hình ảnh Docker, hãy đảm bảo bạn đã cài đặt Docker trên hệ thống của mình và truyền thông tin xác thực Cloudinary của bạn dưới dạng biến môi trường khi chạy container. Xem tài liệu hình ảnh Docker cụ thể trên Docker Hub để biết hướng dẫn sử dụng chi tiết.

Ví dụ cấu hình

Cấu hình máy chủ MCP từ xa

Các máy chủ từ xa được Cloudinary lưu trữ và truy cập qua 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"
    }
  }
}

Vận chuyển: Các máy chủ từ xa hỗ trợ hai điểm cuối — /mcp (Streamable HTTP, khuyến nghị, không trạng thái) và /sse (SSE, không dùng nữa, giữ để tương thích ngược). Điểm cuối /sse cũng chấp nhận các yêu cầu POST như một bí danh cho /mcp, vì vậy các máy khách gửi Streamable HTTP đến /sse sẽ hoạt động. Sử dụng /mcp cho các cấu hình mới.

Máy chủ MCP từ xa với xác thực

Các máy chủ MCP từ xa được Cloudinary lưu trữ sử dụng OAuth2 theo mặc định để xác thực. Bạn cũng có thể xác thực bằng khóa API qua các tiêu đề:

Sử dụng CLOUDINARY_URL (Đơn giản nhất)

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

Sử dụng các tiêu đề riêng lẻ

{
  "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"
      }
    }
  }
}

Với cấu hình tùy chỉnh

{
  "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"
      }
    }
  }
}

Với tiêu đề gỡ lỗi

Để hiển thị các tiêu đề giới hạn tốc độ API và ID yêu cầu trong kết quả công cụ, hãy bật nhúng tiêu đề:

{
  "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"
      }
    }
  }
}

Mỗi kết quả công cụ sẽ bao gồm một trường _headers với thông tin giới hạn tốc độ và theo dõi yêu cầu:

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

Cấu hình máy chủ MCP cục bộ

Các máy chủ cục bộ chạy trên máy của bạn bằng các gói npm:

Tùy chọn 1: Sử dụng biến môi trường CLOUDINARY_URL (Khuyến nghị)

{
  "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"
      }
    }
  }
}

Tùy chọn 2: Sử dụng các biến môi trường riêng lẻ

{
  "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"
      }
    }
  }
}

Tùy chọn 3: Sử dụng đối số dòng lệnh

{
  "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"
      ]
    }
  }
}

Cấu hình máy chủ MCP MediaFlows

Đối với MediaFlows, hãy sử dụng cấu hình sau:

{
  "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"
      }
    }
  }
}

Cấu hình máy chủ cục bộ nâng cao

Mỗi gói npm hỗ trợ các tùy chọn cấu hình bổ sung ngoài các ví dụ thiết lập cơ bản ở trên.

Chạy dưới dạng máy chủ SSE

Để chạy máy chủ MCP cục bộ bằng vận chuyển Server-Sent Events (SSE) thay vì stdio:

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

Bạn có thể chỉ định một cổng tùy chỉnh (mặc định là 2718):

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

Các tùy chọn cấu hình có sẵn

Để xem tất cả các tùy chọn cấu hình có sẵn cho bất kỳ gói nào:

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

Danh sách đầy đủ các cờ có sẵn:

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

Gỡ lỗi

Để gỡ lỗi chi tiết tải trọng mạng, hãy sử dụng biến môi trường CLOUDINARY_DEBUG:

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

Bạn có thể kết hợp chế độ gỡ lỗi với các tùy chọn khác để khắc phục sự cố toàn diện:

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

Lưu ý: Các tùy chọn cấu hình này áp dụng cho tất cả các gói MCP cục bộ:

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

Xác thực

Khi chạy các máy chủ MCP cục bộ, xác thực có thể được cấu hình theo nhiều cách:

Tùy chọn 1: Các biến môi trường riêng lẻ (Khuyến nghị)

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

Tùy chọn 2: Biến môi trường CLOUDINARY_URL

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

Tùy chọn 3: Đối số dòng lệnh

Truyền thông tin xác thực trực tiếp dưới dạng đối số (xem các ví dụ cấu hình ở trên)

Bạn có thể tìm thông tin xác thực Cloudinary của mình trong Bảng điều khiển Cloudinary Console trong Cài đặt > Bảo mật.

Tính năng theo máy chủ

Máy chủ quản lý tài nguyên

  • Tải lên và quản lý các tài nguyên phương tiện (hình ảnh, video, tệp thô)
  • Tìm kiếm và tổ chức tài nguyên với khả năng lọc nâng cao
  • Xử lý các thao tác và chuyển đổi tài nguyên
  • Quản lý thư mục, thẻ và mối quan hệ tài nguyên
  • Tạo kho lưu trữ và liên kết tải xuống

Máy chủ cấu hình môi trường

  • Cấu hình cài đặt trước tải lên và cài đặt chuyển đổi
  • Quản lý hồ sơ phát trực tuyến và thông báo webhook
  • Thiết lập ánh xạ tải lên

Máy chủ siêu dữ liệu có cấu trúc

  • Tạo và quản lý các trường siêu dữ liệu có cấu trúc
  • Cấu hình các quy tắc siêu dữ liệu có điều kiện và xác thực
  • Tổ chức và tìm kiếm các cấu hình siêu dữ liệu
  • Xử lý các mối quan hệ trường siêu dữ liệu và thứ tự

Máy chủ phân tích

  • Phân tích nội dung hỗ trợ AI bao gồm gắn thẻ, kiểm duyệt và chú thích
  • Phát hiện và nhận dạng đối tượng với nhiều mô hình AI
  • Phân tích chất lượng hình ảnh và phát hiện hình mờ
  • Kiểm duyệt nội dung và phân tích an toàn
  • Khả năng phát hiện thời trang, văn bản và giải phẫu

Máy chủ MediaFlows

  • Xây dựng và quản lý các tự động hóa quy trình làm việc bằng ngôn ngữ tự nhiên
  • Truy vấn các tự động hóa PowerFlow hiện có trong môi trường của bạn
  • Tạo logic có điều kiện dựa trên siêu dữ liệu, thẻ và thuộc tính tài nguyên
  • Tự động hóa các quy trình kiểm duyệt, phê duyệt và thông báo tài nguyên
  • Gỡ lỗi và hiểu các cấu hình tự động hóa hiện có

Cần truy cập nhiều công cụ Cloudinary hơn?

Chúng tôi tiếp tục bổ sung thêm chức năng cho các máy chủ MCP này. Nếu bạn muốn gửi phản hồi, báo cáo lỗi hoặc cung cấp yêu cầu tính năng, vui lòng mở một vấn đề trên kho lưu trữ này.

Xử lý sự cố

"Phản hồi của Claude đã bị gián đoạn..."

Nếu bạn thấy thông báo này, Claude có thể đã đạt đến giới hạn độ dài ngữ cảnh và dừng giữa chừng. Điều này thường xảy ra nhất trên các máy chủ kích hoạt nhiều lệnh gọi công cụ được xâu chuỗi như máy chủ quản lý tài nguyên với danh sách tài nguyên lớn.

Để giảm khả năng gặp phải vấn đề này:

  • Cố gắng cụ thể, giữ cho truy vấn của bạn ngắn gọn.
  • Nếu một yêu cầu duy nhất gọi nhiều công cụ, hãy cố gắng chia nó thành nhiều lệnh gọi công cụ nhỏ hơn để giữ cho phản hồi ngắn.
  • Sử dụng các tham số lọc để giới hạn phạm vi tìm kiếm và danh sách tài nguyên.

Vấn đề xác thực

Đảm bảo thông tin xác thực Cloudinary của bạn được cấu hình chính xác và có các quyền cần thiết cho các thao tác bạn đang cố gắng thực hiện.

Tính năng trả phí

Một số tính năng có thể yêu cầu gói Cloudinary trả phí. Đảm bảo tài khoản Cloudinary của bạn có mức đăng ký cần thiết cho các tính năng bạn định sử dụng, chẳng hạn như:

  • Các tính năng phân tích AI nâng cao
  • Sử dụng API khối lượng lớn
  • Khả năng chuyển đổi nâng cao

Giấy phép

Được cấp phép theo Giấy phép MIT. Xem tệp LICENSE để biết chi tiết.