mediamcp

Научите любого ИИ-агента создавать изображения и видео

mediamcp— это MCP-сервер, который соединяет вашего ИИ-ассистента — Claude Code, Claude Desktop,
Cursor, Windsurf, VS Code или любой другой клиент с поддержкой MCP — с облачными медиамоделями
(Gemini Flash Image, GPT-5 Image, Seedream, Veo, Sora, …) черезOpenRouterили любой OpenAI-совместимый API.

ИИ-агентам:инструкция по установке, оптимизированная специально для вас, лежит вllms-install.md.

Вам понадобится API-ключ OpenRouter— получить его можно наhttps://openrouter.ai/keys.

claude mcp add mediamcp -e OPENROUTER_API_KEY=sk-or-v1-YOUR_KEY -- npx -y mediamcp

{ "mcpServers": { "mediamcp": { "command": "npx", "args": ["-y", "mediamcp"], "env": { "OPENROUTER_API_KEY": "sk-or-v1-YOUR_KEY" } } } }

{ "mcpServers": { "mediamcp": { "command": "npx", "args": ["-y", "mediamcp"], "env": { "OPENROUTER_API_KEY": "sk-or-v1-YOUR_KEY" } } } }

Добавьте в~/.codeium/windsurf/mcp_config.json:

{ "mcpServers": { "mediamcp": { "command": "npx", "args": ["-y", "mediamcp"], "env": { "OPENROUTER_API_KEY": "sk-or-v1-YOUR_KEY" } } } }

Или добавьте в.vscode/mcp.json(ключ запрашивается отдельно и не попадает в файл):

{ "servers": { "mediamcp": { "command": "npx", "args": ["-y", "mediamcp"], "env": { "OPENROUTER_API_KEY": "${input:openrouter-key}" } } }, "inputs": [ { "id": "openrouter-key", "type": "promptString", "password": true, "description": "OpenRouter API key (https://openrouter.ai/keys)" } ] }

После установки просто скажите агенту что-нибудь вроде«сгенерируй hero-изображение для моего лендинга, 16:9»,«убери фон с logo.png»,«сделай 8-секундное видео с океанскими волнами на закате»или«оживи logo.png в 4-секундное видео»(image-to-video). Агент сам выберет подходящий инструмент:

Всё настраивается через переменные окружения в блокеenvконфигурации вашего MCP-клиента:

Укажите вMEDIAMCP_BASE_URLлюбой OpenAI-совместимый эндпоинт и задайте соответствующий ключ:

"env": { "MEDIAMCP_BASE_URL": "https://your-endpoint.example.com/v1", "MEDIAMCP_API_KEY": "your-key", "MEDIAMCP_MODEL": "your/image-model" }

mediamcp сам определяет, какой формат API поддерживает эндпоинт: выделенный эндпоинт/images(OpenRouter),/images/generations(классический OpenAI) илиchat/completionsс поддержкой изображений — первый сработавший вариант запоминается.
- Попросите агента запустить инструментcheck_config— он сообщит, что именно настроено неверно и как это исправить.
- Ту же диагностику можно запустить из терминала:npx -y mediamcp --check(используются переменные окружения вашей оболочки).
- Типичные проблемы:

- «No API key configured»— добавьтеOPENROUTER_API_KEYв блокenvзаписи сервера в конфигурации MCP-клиента (а не только в профиль оболочки) и перезапустите клиент.
- «Out of credits (HTTP 402)»— пополните баланс наhttps://openrouter.ai/credits.
- «Not found (HTTP 404) … for model»— неверный слаг модели; запуститеlist_models.
- В клиенте ничего не происходит— убедитесь, что установлен Node.js ≥ 20 (node --version).
- «Tool '…' has an invalid outputSchema … unsupported dialect»— клиент проверяет схемы только по JSON Schema 2020-12. mediamcp публикует 2020-12 по умолчанию, так что ошибка означает старую версию: обновитесь и убедитесь, чтоcheck_configпоказываетtool schema dialect: 2020-12.

git clone https://github.com/legolev/mediamcp && cd mediamcp npm install npm run build # сборка в dist/index.js npm test # юнит-тесты (vitest) npm run inspect # открыть MCP Inspector с собранным сервером

Add one endpoint and Claude, Cursor, or any MCP client can make video, images, music, and speech in chat. 100+ models, one API key.