Mediamcp

io.github.legolev由 GitHub 账号 legolev 发布v0.3.0更新于 Oct 24, 2026

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

已验证STDIO仅桌面媒体与设计AI 与机器学习

概览

AI 生成的概览

一个本地 MCP 服务器，让 AI 助手通过 OpenRouter 或任意 OpenAI 兼容媒体 API 生成和编辑图片、制作视频。

可以做什么
根据文本提示生成图片，支持最多四个变体、宽高比和模型覆盖，保存到磁盘并返回文件路径与预览。编辑已有图片，可接受文件路径或 URL，并可将多张图合成一个画面。由文本或首帧、尾帧、参考图生成视频，并可通过轮询地址或任务 id 继续等待视频任务。列出可用的图片与视频模型及其价格。运行配置检查，覆盖 API 密钥、端点、默认值和输出目录可写性。
适用场景
适合在聊天或编程客户端中让助手产出或修改视觉素材：主视觉图、去背景、修改 logo、短视频或让静态图动起来。也适合希望生成文件落在本地目录并按路径引用的工作流。
运行要求
通过 npx 在本地运行，需要 Node.js 20 或更高版本。需要 OPENROUTER_API_KEY 中的 OpenRouter API 密钥；若使用其他 OpenAI 兼容端点，则需 MEDIAMCP_API_KEY 和 MEDIAMCP_BASE_URL。可选变量用于设置默认图片与视频模型、输出目录、超时、预览尺寸和 schema 方言。需要能访问所选 API 的网络。
安装前请注意
API 密钥是付费凭据，以明文形式放在客户端 env 配置中，避免写入共享配置文件。生成会消耗 OpenRouter 额度，余额不足时会报错。生成的文件会写入输出目录，图片编辑接受远程 URL，因此内容会发送给所配置的第三方 API。视频任务可能耗时数分钟。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mediamcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[mediamcp]

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

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

[npm version] [CI] [node >= 20] [license: MIT]

English | Русский

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

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

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

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

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

Claude Code

bash
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:

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

Cursor

[Install MCP Server]

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

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

Windsurf

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

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

VS Code (GitHub Copilot)

[Install in VS Code]

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

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). Агент сам выберет подходящий инструмент:

ИнструментЧто делает
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_images — как референс стиля. Нужна i2v-модель (bytedance/seedance-2.0, bytedance/seedance-2.0-fast, google/veo-3.1). Дожидается результата, сохраняет mp4, возвращает путь. При таймауте возвращает polling_url.
check_video_statusВозобновляет ожидание видеозадачи по polling_url / id; по готовности скачивает результат.
list_modelsВыводит слаги и цены моделей с поддержкой изображений/видео — агент сможет сам подобрать модель.
check_configДиагностика: наличие и валидность ключа, эндпоинт, значения по умолчанию, возможность записи в каталог вывода. Если что-то не работает — запускайте его первым.

Конфигурация

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

ПеременнаяПо умолчаниюНазначение
OPENROUTER_API_KEY—Обязательна. Ваш ключ OpenRouter.
MEDIAMCP_API_KEY—Псевдоним OPENROUTER_API_KEY для эндпоинтов, отличных от OpenRouter; имеет приоритет, если заданы обе переменные.
MEDIAMCP_BASE_URLhttps://openrouter.ai/api/v1Корневой URL любого OpenAI-совместимого API.
MEDIAMCP_MODELgoogle/gemini-2.5-flash-imageСлаг модели изображений по умолчанию.
MEDIAMCP_VIDEO_MODELgoogle/veo-3.1Слаг видеомодели по умолчанию.
MEDIAMCP_OUTPUT_DIR~/Pictures/mediamcpКуда сохранять сгенерированные файлы (~/mediamcp, если ~/Pictures не существует).
MEDIAMCP_TIMEOUT_MS120000HTTP-таймаут на один запрос.
MEDIAMCP_PREVIEWtrueВозвращать встроенное превью вместе с каждым результатом (false — только пути).
MEDIAMCP_PREVIEW_MAX_DIM768Длинная сторона встроенного превью в пикселях.
MEDIAMCP_SCHEMA_DIALECT2020-12Диалект JSON Schema, в котором публикуются схемы инструментов. Значение draft-7 отдаёт вывод MCP SDK как есть.

Использование другого провайдера

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

json
"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.

Разработка

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

Лицензия

MIT

mcp-name: io.github.legolev/mediamcp

来源：README.md，提交 ff7058e

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.3.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分