Mediamcp

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

mediamcp — это MCP-сервер, который соединяет вашего ИИ-ассистента — Claude Code, Claude Desktop,

Cursor, Windsurf, VS Code или любой другой клиент с поддержкой MCP — с облачными медиамоделями

(Gemini Flash Image, GPT-5 Image, Seedream, Veo, Sora, …) через OpenRouter или любой OpenAI-совместимый API.

English | Русский

⭐ Баннер выше сгенерирован самим mediamcp — один вызов generate_image.

Сгенерированные файлы всегда сохраняются на диск (по умолчанию в ~/Pictures/mediamcp), а каждый ответ содержит абсолютный путь к файлу и небольшое встроенное превью — агент сразу видит, что у него получилось.

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

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

Быстрая установка

Claude Code

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

Claude Desktop

Добавьте в claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json) и перезапустите Claude Desktop:

{

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

Cursor

Или добавьте в ~/.cursor/mcp.json:

{

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

Windsurf

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

{

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

VS Code (GitHub Copilot)

Или добавьте в .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 с поддержкой изображений — первый сработавший вариант запоминается.

Диагностика проблем

1. Попросите агента запустить инструмент `check_config` — он сообщит, что именно настроено неверно и как это исправить.
2. Ту же диагностику можно запустить из терминала: npx -y mediamcp --check (используются переменные окружения вашей оболочки).
3. Типичные проблемы:

• «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 с собранным сервером

Лицензия

MIT

mcp-name: io.github.legolev/mediamcp