mediamcp

---

生成されたファイルは常にディスクに保存され（デフォルトでは ~/Pictures/mediamcp）、各応答にはファイルの絶対パスと小さなインラインプレビューが含まれるため、エージェントはすぐに生成結果を確認できます。

AI エージェント向け： エージェント向けに最適化されたインストール手順は、llms-install.md をご覧ください。

OpenRouter API キーが必要です。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)"
    }
  ]
}

エージェントにできること

インストール後、エージェントに 「ランディングページ用のヒーロー画像を16:9で生成して」、「logo.pngの背景を削除して」、「夕暮れの海の波を8秒の動画にして」、または 「logo.pngを4秒の動画にして」（画像から動画へ）などと伝えるだけです。エージェントが適切なツールを自動で選択します。

ツール	機能
generate_image	テキスト → 画像（1枚または複数枚）。ディスクに保存し、パスと埋め込みプレビューを返します。count（最大4種類）、aspect_ratio、modelの上書きに対応しています。
edit_image	既存の画像（1枚または複数枚）＋指示 → 編集済み画像。ファイルパス、https://およびdata:URLを受け付けます。複数の画像を指定すると、1つの画像に合成できます。
generate_video	テキスト → 動画 または画像 → 動画（非同期タスク、通常1～5分）。既存の画像を動かすにはfirst_frame_image（画像から動画へ）、最終フレームには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	診断を行います。キーの有無と有効性、エンドポイント、デフォルト値、出力ディレクトリへの書き込み可否を確認します。問題がある場合は、最初に実行してください。

設定

MCP クライアントの設定にあるenvブロックで、環境変数を使ってすべて設定できます。

変数	デフォルト	用途
OPENROUTER_API_KEY	—	必須です。 OpenRouterのキーです。
MEDIAMCP_API_KEY	—	OpenRouter以外のエンドポイント用のOPENROUTER_API_KEYの別名です。両方の変数が設定されている場合は、こちらが優先されます。
MEDIAMCP_BASE_URL	https://openrouter.ai/api/v1	OpenAI互換APIのベースURLです。
MEDIAMCP_MODEL	google/gemini-2.5-flash-image	デフォルトの画像モデルのスラグです。
MEDIAMCP_VIDEO_MODEL	google/veo-3.1	デフォルトの動画モデルのスラグです。
MEDIAMCP_OUTPUT_DIR	~/Pictures/mediamcp	生成ファイルの保存先です（~/Picturesが存在しない場合は~/mediamcp）。
MEDIAMCP_TIMEOUT_MS	120000	1リクエストあたりのHTTPタイムアウトです。
MEDIAMCP_PREVIEW	true	各結果とともに埋め込みプレビューを返します（falseの場合はパスのみ）。
MEDIAMCP_PREVIEW_MAX_DIM	768	埋め込みプレビューの長辺のピクセル数です。
MEDIAMCP_SCHEMA_DIALECT	2020-12	ツールのスキーマを公開する際のJSON Schemaの方言です。draft-7を指定すると、MCP SDKの出力をそのまま返します。

別のプロバイダーの使用

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」 — MCP クライアントの設定にあるサーバーエントリの env ブロックに OPENROUTER_API_KEY を追加し（シェルのプロファイルだけでなく）、クライアントを再起動してください。
   • 「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}