Mediamcp MCP Server

Generate and edit images and video via OpenRouter or any OpenAI-compatible API.

Local serverstdio

What is the Mediamcp MCP server?

Generate and edit images and video via OpenRouter or any OpenAI-compatible API. That is what the mediamcp mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

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

The tools it exposes

The server publishes 14 tools. What each one is for:

  • generate_image — Текст → изображение (одно или несколько). Сохраняет на диск, возвращает путь и встроенное превью. Поддерживает count (до 4 вариаций), aspect_ratio и
  • edit_image — Существующее изображение (одно или несколько) + инструкция → отредактированное изображение. Принимает пути к файлам, https://- и data:-URL; несколько
  • generate_video — Текст → видео или картинка → видео (асинхронная задача, обычно 1–5 минут). Передайте first_frame_image, чтобы оживить существующую картинку
  • check_video_status — Возобновляет ожидание видеозадачи по polling_url / id; по готовности скачивает результат
  • list_models — Выводит слаги и цены моделей с поддержкой изображений/видео — агент сможет сам подобрать модель
  • check_config — Диагностика: наличие и валидность ключа, эндпоинт, значения по умолчанию, возможность записи в каталог вывода. Если что-то не работает — запускайте
  • OPENROUTER_API_KEY — —
  • MEDIAMCP_API_KEY — —
  • MEDIAMCP_BASE_URLhttps://openrouter.ai/api/v1
  • MEDIAMCP_MODEL — google/gemini-2.5-flash-image
  • MEDIAMCP_VIDEO_MODEL — google/veo-3.1
  • MEDIAMCP_OUTPUT_DIR — ~/Pictures/mediamcp

What it needs from you

Configuration is passed through the environment: OPENROUTER_API_KEY, MEDIAMCP_BASE_URL, MEDIAMCP_API_KEY, MEDIAMCP_MODEL, YOUR_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Getting it running

The server ships on npm as mediamcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

How it compares

Among the AI and media services options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Mediamcp's toolset — generate_image, edit_image, generate_video and 11 more — is a fair guide to whether it matches your workflow. It is maintained by legolev; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Mediamcp's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Mediamcp.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
generate_imageТекст → изображение (одно или несколько). Сохраняет на диск, возвращает путь и встроенное превью. Поддерживает count (до 4 вариаций), aspect_ratio и переопределение model.
edit_imageСуществующее изображение (одно или несколько) + инструкция → отредактированное изображение. Принимает пути к файлам, https://- и data:-URL; несколько источников — для объединения изображений в одну композицию.
generate_videoТекст → видео **или картинка → видео** (асинхронная задача, обычно 1–5 минут). Передайте first_frame_image, чтобы оживить существующую картинку (image-to-video), last_frame_image — для финального кадра, или reference_ima
check_video_statusВозобновляет ожидание видеозадачи по polling_url / id; по готовности скачивает результат.
list_modelsВыводит слаги и цены моделей с поддержкой изображений/видео — агент сможет сам подобрать модель.
check_configДиагностика: наличие и валидность ключа, эндпоинт, значения по умолчанию, возможность записи в каталог вывода. Если что-то не работает — запускайте его первым.
OPENROUTER_API_KEY
MEDIAMCP_API_KEY
MEDIAMCP_BASE_URLhttps://openrouter.ai/api/v1
MEDIAMCP_MODELgoogle/gemini-2.5-flash-image
MEDIAMCP_VIDEO_MODELgoogle/veo-3.1
MEDIAMCP_OUTPUT_DIR~/Pictures/mediamcp
MEDIAMCP_TIMEOUT_MS120000
MEDIAMCP_PREVIEWtrue

How to install the Mediamcp MCP server

{
  "mcpServers": {
    "mediamcp": {
      "command": "npx",
      "args": ["-y", "mediamcp"],
      "env": {
        "OPENROUTER_API_KEY": "your-value",
        "MEDIAMCP_BASE_URL": "your-value",
        "MEDIAMCP_API_KEY": "your-value",
        "MEDIAMCP_MODEL": "your-value",
        "YOUR_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
OPENROUTER_API_KEYCredential the server authenticates with.Yes
MEDIAMCP_BASE_URLEndpoint or connection string the server talks to.Yes
MEDIAMCP_API_KEYCredential the server authenticates with.Yes
MEDIAMCP_MODELConfiguration value read at startup.Optional
YOUR_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Mediamcp to generate image.
  • Use Mediamcp to edit image.
  • Use Mediamcp to generate video.

Frequently asked questions

It connects Mediamcp to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (generate_image, edit_image, generate_video, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Mediamcp directly.