midjourney-mcp

RunAPI Midjourney MCP サーバー

AI エージェントから Midjourney API にアクセスできます。1 つの専用 MCP サーバーを通じて、画像や動画の生成操作の実行、非同期処理の結果のポーリング、料金の確認が可能です。

_{Claude Code、Codex、Cursor、Windsurf、VS Code、Roo Code、および MCP 互換のあらゆるホストで動作します。}

インストール | ツール | モデル | エージェントのプロンプト | 設定 | リンク

---

このパッケージを使う理由

@runapi.ai/midjourney-mcp は、RunAPI の Midjourney モデルシリーズに特化した Model Context Protocol サーバーです。 RunAPI のカタログ全体を読み込まずに、MCP 対応のアシスタントから 7 つのエンドポイントと 3 種類のモデルに直接アクセスできます。

エージェントの対象を Midjourney に限定する場合は、このモデル専用サーバーを使用してください。1 つのアシスタントで RunAPI のすべてのモデルシリーズを検出する場合は、@runapi.ai/mcp を使用してください。

---

インストール

Claude Code に追加します。

claude mcp add midjourney -s user -- npx -y @runapi.ai/midjourney-mcp

サーバーをリポジトリで共有する場合は、プロジェクトスコープを使用します。

claude mcp add midjourney -s project -- npx -y @runapi.ai/midjourney-mcp

Codex、Cursor、Windsurf、VS Code、Roo Code、およびその他の MCP ホストでは、同じ stdio コマンドを使用できます。

{
  "mcpServers": {
    "midjourney": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/midjourney-mcp"]
    }
  }
}

check_pricing はサインイン前でも動作します。タスクの作成とステータスのポーリングを行うには、アシスタントに login ツールを呼び出すよう依頼してください。ブラウザーでログイン画面が開き、runapi login が使用するものと同じ ~/.config/runapi/config.json に認証情報が保存されます。 ヘッドレス環境や CI ホストでも、MCP ホストの起動前に RUNAPI_API_KEY を設定して使用できます。

Claude、Cursor、Windsurf、VS Code、Roo Code 向けのすぐに使える例は、examples/ にあります。

---

ツール

ツール	認証	用途
edit_image	はい	Midjourney の画像編集タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
extend_video	はい	Midjourney の動画延長タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
get_seed	はい	Midjourney のシード取得操作を同期的に実行します。操作結果を返します。
image_to_prompt	はい	Midjourney の画像からプロンプトへの変換操作を同期的に実行します。操作結果を返します。
image_to_video	はい	Midjourney の画像から動画への変換タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
shorten_prompt	はい	Midjourney のプロンプト短縮操作を同期的に実行します。操作結果を返します。
text_to_image	はい	Midjourney のテキストから画像への変換タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
get_task	はい	既存のタスクの現在のステータスと最新のペイロードを取得します。
check_pricing	いいえ	Midjourney のモデルとエンドポイントの現在の料金を確認します。

---

モデル

Midjourney は、7 つのエンドポイントで 3 種類のモデルを提供しています。各ツールで指定できるモデルは次のとおりです。

ツール	モデル
edit_image	midjourney-edit-image
extend_video	midjourney-image-to-video
get_seed	モデルパラメーターなし
image_to_prompt	モデルパラメーターなし
image_to_video	midjourney-image-to-video
shorten_prompt	モデルパラメーターなし
text_to_image	midjourney-v8.1

モデルの提供状況はリリースごとに変わる場合があります。最新のカタログを確認するには、check_pricing または Midjourney のモデルページ をご利用ください。

---

エージェント向けプロンプト

アシスタントには自然言語で依頼できます。料金を確認し、タスクを作成して、タスク ID と出力 URL を返します。

タスクを作成する

Run a Midjourney edit image task with RunAPI.

アシスタントは check_pricing、続いて edit_image を呼び出し、タスク ID、ステータス、出力 URL を返します。

待たずに送信する

Create the task but don't wait for it to finish.

アシスタントは wait: false を指定して作成ツールを呼び出し、タスク ID を返します。後で get_task を使って確認できます。

作成前に料金を確認する

Check current Midjourney pricing, then create the task if it matches my request.

アシスタントは check_pricing を呼び出します。また、正規のカタログ項目へのリンクとして Midjourney のモデルページ を案内できます。

---

設定

サーバーは次の優先順で認証情報を解決します。

1. ヘッドレス環境や CI ホストに便利な RUNAPI_API_KEY 環境変数
2. MCP の login ツールまたは runapi login で作成される ~/.config/runapi/config.json
3. キーなし。この場合も check_pricing は利用できます

通常、設定ファイルはログインによって管理されます。事前に用意するヘッドレス環境用の設定では、次のようにできます。

{
  "apiKey": "your_runapi_key"
}

実際の API キーをコミットしないでください。

---

リンク

リソース	URL
Midjourney のモデルページ	https://runapi.ai/models/midjourney
npm パッケージ	@runapi.ai/midjourney-mcp
GitHub リポジトリ	runapi-ai/midjourney-mcp
RunAPI MCP の概要	runapi.ai/mcp
RunAPI ドキュメント	runapi.ai/docs

---

ライセンス

Apache License, Version 2.0 に基づいてライセンスされています。