{"id":51432642,"url":"https://github.com/cloudinary/media-generation-mcp","last_synced_at":"2026-07-05T05:01:59.998Z","repository":{"id":367975720,"uuid":"1282885187","full_name":"cloudinary/media-generation-mcp","owner":"cloudinary","description":"Generates images from text prompts across multiple AI model families (FLUX, Recraft, GPT Image, Nano Banana, Ideogram), with generated assets available through Cloudinary for delivery and transformation.","archived":false,"fork":false,"pushed_at":"2026-06-28T13:23:44.000Z","size":183,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-28T15:12:47.425Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudinary.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-28T10:00:15.000Z","updated_at":"2026-06-28T13:22:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/cloudinary/media-generation-mcp","commit_stats":null,"previous_names":["cloudinary/media-generation-mcp"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/cloudinary/media-generation-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudinary%2Fmedia-generation-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudinary%2Fmedia-generation-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudinary%2Fmedia-generation-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudinary%2Fmedia-generation-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudinary","download_url":"https://codeload.github.com/cloudinary/media-generation-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudinary%2Fmedia-generation-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35143802,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-05T02:00:06.290Z","response_time":100,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-05T05:01:59.215Z","updated_at":"2026-07-05T05:01:59.980Z","avatar_url":"https://github.com/cloudinary.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cloudinary Media Generation MCP Server\n\n\u003c!-- mcp-name: io.github.cloudinary/media-generation-mcp --\u003e\n\n\u003c!-- Start Summary [summary] --\u003e\n## Summary\n\nImage Generation API: Use the Image Generation API to generate images from text prompts using various AI models.\n\nThe API supports Basic Authentication using your Cloudinary API Key and API Secret, which can be found on the [API Keys page](https://console.cloudinary.com/app/settings/api-keys) of your Cloudinary Console.\n\n**Key Features:**\n* **Unified API**: A single interface for generating images across multiple best-in-class AI models.\n* **Cloudinary Integration**: Generated images are automatically available for delivery, transformation, and optimization through Cloudinary's platform.\n* **Future-proof**: Adopt new state-of-the-art models as they become available, without rebuilding your integration.\n\n**Supported Model Families:**\n* **flux**: Photorealistic images (FLUX.2 Klein 9B / FLUX.2 Pro).\n* **recraft**: Vector and illustration (Recraft V3 / Recraft V4).\n* **gpt-image**: Campaign and marketing images (GPT Image 1 Mini / GPT Image 2).\n* **nano-banana**: General purpose generation (Nano Banana 1 / Nano Banana 2).\n* **ideogram**: Realism, text rendering, and artistic generation (Ideogram V4).\n\nThe Image Generation API requires the [Cloudinary Image Generation add-on](https://console.cloudinary.com/app/marketplace/details/image_generation).\n\n[Learn more](https://cloudinary.com/documentation/image_generation_addon)\n\n**Note**: \n\nThis is an early version of our Image Generation API. As the capability grows, certain features and endpoints may be adjusted. We invite you to try it out and share your [feedback with our support team](https://support.cloudinary.com/hc/en-us/requests/new).\n\u003c!-- End Summary [summary] --\u003e\n\n\u003c!-- Start Table of Contents [toc] --\u003e\n## Table of Contents\n\u003c!-- $toc-max-depth=2 --\u003e\n* [Cloudinary Media Generation MCP Server](#cloudinary-media-generation-mcp-server)\n  * [Installation](#installation)\n  * [Custom server / non-default host](#custom-server-non-default-host)\n  * [Progressive Discovery](#progressive-discovery)\n  * [Development](#development)\n  * [Contributions](#contributions)\n\n\u003c!-- End Table of Contents [toc] --\u003e\n\n\u003c!-- Start Installation [installation] --\u003e\n## Installation\n\n\u003cdetails\u003e\n\u003csummary\u003eClaude Desktop\u003c/summary\u003e\n\nInstall the MCP server as a Desktop Extension using the pre-built [`mcp-server.mcpb`](https://github.com/cloudinary/media-generation-mcp/releases/download/v1.0.0/mcp-server.mcpb) file:\n\nSimply drag and drop the [`mcp-server.mcpb`](https://github.com/cloudinary/media-generation-mcp/releases/download/v1.0.0/mcp-server.mcpb) file onto Claude Desktop to install the extension.\n\nThe MCP bundle package includes the MCP server and all necessary configuration. Once installed, the server will be available without additional setup.\n\n\u003e [!NOTE]\n\u003e MCP bundles provide a streamlined way to package and distribute MCP servers. Learn more about [Desktop Extensions](https://www.anthropic.com/engineering/desktop-extensions).\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eCursor\u003c/summary\u003e\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=CloudinaryMediaGeneration\u0026config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJAY2xvdWRpbmFyeS9tZWRpYS1nZW5lcmF0aW9uLW1jcCIsInN0YXJ0IiwiLS1hcGkta2V5IiwiIiwiLS1hcGktc2VjcmV0IiwiIiwiLS1jbG91ZC1uYW1lIiwiIl19)\n\nOr manually:\n\n1. Open Cursor Settings\n2. Select Tools and Integrations\n3. Select New MCP Server\n4. If the configuration file is empty paste the following JSON into the MCP Server Configuration:\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\n    \"@cloudinary/media-generation-mcp\",\n    \"start\",\n    \"--api-key\",\n    \"\",\n    \"--api-secret\",\n    \"\",\n    \"--cloud-name\",\n    \"\"\n  ]\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eClaude Code CLI\u003c/summary\u003e\n\n```bash\nclaude mcp add CloudinaryMediaGeneration -- npx -y @cloudinary/media-generation-mcp start --api-key  --api-secret  --cloud-name \n```\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003eGemini\u003c/summary\u003e\n\n```bash\ngemini mcp add CloudinaryMediaGeneration -- npx -y @cloudinary/media-generation-mcp start --api-key  --api-secret  --cloud-name \n```\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003eWindsurf\u003c/summary\u003e\n\nRefer to [Official Windsurf documentation](https://docs.windsurf.com/windsurf/cascade/mcp#adding-a-new-mcp-plugin) for latest information\n\n1. Open Windsurf Settings\n2. Select Cascade on left side menu\n3. Click on `Manage MCPs`. (To Manage MCPs you should be signed in with a Windsurf Account)\n4. Click on `View raw config` to open up the mcp configuration file.\n5. If the configuration file is empty paste the full json\n\n```bash\n{\n  \"command\": \"npx\",\n  \"args\": [\n    \"@cloudinary/media-generation-mcp\",\n    \"start\",\n    \"--api-key\",\n    \"\",\n    \"--api-secret\",\n    \"\",\n    \"--cloud-name\",\n    \"\"\n  ]\n}\n```\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003eVS Code\u003c/summary\u003e\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square\u0026label=Install%20CloudinaryMediaGeneration%20MCP\u0026color=0098FF)](vscode://ms-vscode.vscode-mcp/install?name=CloudinaryMediaGeneration\u0026config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJAY2xvdWRpbmFyeS9tZWRpYS1nZW5lcmF0aW9uLW1jcCIsInN0YXJ0IiwiLS1hcGkta2V5IiwiIiwiLS1hcGktc2VjcmV0IiwiIiwiLS1jbG91ZC1uYW1lIiwiIl19)\n\nOr manually:\n\nRefer to [Official VS Code documentation](https://code.visualstudio.com/api/extension-guides/ai/mcp) for latest information\n\n1. Open [Command Palette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette)\n1. Search and open `MCP: Open User Configuration`. This should open mcp.json file\n2. If the configuration file is empty paste the full json\n\n```bash\n{\n  \"command\": \"npx\",\n  \"args\": [\n    \"@cloudinary/media-generation-mcp\",\n    \"start\",\n    \"--api-key\",\n    \"\",\n    \"--api-secret\",\n    \"\",\n    \"--cloud-name\",\n    \"\"\n  ]\n}\n```\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e Stdio installation via npm \u003c/summary\u003e\nTo start the MCP server, run:\n\n```bash\nnpx @cloudinary/media-generation-mcp start --api-key  --api-secret  --cloud-name \n```\n\nFor a full list of server arguments, run:\n\n```\nnpx @cloudinary/media-generation-mcp --help\n```\n\n\u003c/details\u003e\n\u003c!-- End Installation [installation] --\u003e\n\n## Custom server / non-default host\n\nBy default the server talks to the production Cloudinary API\n(`https://api.cloudinary.com/v2`). To point it at a different host — staging, a\nregional endpoint, or a local mock — pass `--server-url` (or for clients that\nuse a config block, add it to `args`):\n\n```bash\nnpx @cloudinary/media-generation-mcp start \\\n  --api-key  --api-secret  --cloud-name  \\\n  --server-url https://api-eu.cloudinary.com/v2\n```\n\nIn a client config block:\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\n    \"@cloudinary/media-generation-mcp\",\n    \"start\",\n    \"--api-key\", \"\",\n    \"--api-secret\", \"\",\n    \"--cloud-name\", \"\",\n    \"--server-url\", \"https://api-eu.cloudinary.com/v2\"\n  ]\n}\n```\n\nNotes:\n\n- **Keep the `/v2` suffix.** Operation paths (`/processing/{cloud_name}/...`) are\n  appended to this base, so a host without `/v2` will return 404s.\n- **`--server-url` overrides the URL entirely.** `--server-index` selects from\n  the schema's `servers` list, which currently has a single entry, so only\n  `--server-index 0` is valid — use `--server-url` for anything else.\n- **`{cloud_name}` is independent of the host.** It is always taken from\n  `--cloud-name` / `CLOUDINARY_CLOUD_NAME` / `CLOUDINARY_URL`, regardless of\n  `--server-url`.\n- Add `--log-level debug` to print the outgoing request URL and confirm the\n  override took effect.\n\n\u003c!-- Start Progressive Discovery [dynamic-mode] --\u003e\n## Progressive Discovery\n\nMCP servers with many tools can bloat LLM context windows, leading to increased token usage and tool confusion. Dynamic mode solves this by exposing only a small set of meta-tools that let agents progressively discover and invoke tools on demand.\n\nTo enable dynamic mode, pass the `--mode dynamic` flag when starting your server:\n\n```jsonc\n{\n  \"mcpServers\": {\n    \"CloudinaryMediaGeneration\": {\n      \"command\": \"npx\",\n      \"args\": [\"@cloudinary/media-generation-mcp\", \"start\", \"--mode\", \"dynamic\"],\n      // ... other server arguments\n    }\n  }\n}\n```\n\nIn dynamic mode, the server registers only the following meta-tools instead of every individual tool:\n\n- **`list_tools`**: Lists all available tools with their names and descriptions.\n- **`describe_tool_input`**: Returns the input schema for one or more tools by name.\n- **`execute_tool`**: Executes a tool by name with its arguments.\n\nThis approach significantly reduces the number of tokens sent to the LLM on each request, which is especially useful for servers with a large number of tools.\n\u003c!-- End Progressive Discovery [dynamic-mode] --\u003e\n\n\u003c!-- Placeholder for Future Speakeasy SDK Sections --\u003e\n\n## Development\n\nRun locally without a published npm package:\n1. Clone this repository\n2. Run `npm install`\n3. Run `npm run build`\n4. Run `node ./bin/mcp-server.js start --api-key  --api-secret  --cloud-name `\n\nTo use this local version with Cursor, Claude or other MCP Clients, you'll need to add the following config:\n\n```json\n{\n  \"command\": \"node\",\n  \"args\": [\n    \"./bin/mcp-server.js\",\n    \"start\",\n    \"--api-key\",\n    \"\",\n    \"--api-secret\",\n    \"\",\n    \"--cloud-name\",\n    \"\"\n  ]\n}\n```\n\nOr to debug the MCP server locally, use the official MCP Inspector:\n\n```bash\nnpx @modelcontextprotocol/inspector node ./bin/mcp-server.js start --api-key  --api-secret  --cloud-name \n```\n\n\n\n## Contributions\n\nWhile we value contributions to this MCP Server, the code is generated programmatically. Any manual changes added to internal files will be overwritten on the next generation. \nWe look forward to hearing your feedback. Feel free to open a PR or an issue with a proof of concept and we'll do our best to include it in a future release. \n\n### MCP Server Created by [Speakeasy](https://www.speakeasy.com/?utm_source=@cloudinary/media-generation-mcp\u0026utm_campaign=mcp-typescript)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudinary%2Fmedia-generation-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudinary%2Fmedia-generation-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudinary%2Fmedia-generation-mcp/lists"}