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 分