mcp-image

MCP Image Generator 🍌

Codex、Cursor、Claude Code、またはあらゆる MCP クライアントから画像を生成・編集できます。mcp-image は、Gemini、OpenAI、または BytePlus Seedream にリクエストを送信する前に、視覚的な方向性を加えます。

作成したい画像、既存の画像で変更したい内容、そしてその用途を伝えてください。結果はディスクに保存され、アシスタントに返されます。

できること

画像を生成する前に、mcp-image は短いリクエストを、より具体的なプロンプトに書き換えます。依頼された内容は維持しつつ、構図、照明、カメラアングルなどの詳細を補います。詳しく指定するほど、変更は少なくなります。

リクエスト：

「レシピサイト用のローストチキンディナーの写真。実際に調理したように見せ、ジューシーさがわかるように、切り分けの途中にしてください。」

mcp-image が画像モデルに送信する内容：

「……素朴な、使い込まれた木製のカービングボードに置かれた、焼きたての丸ごとのローストチキン。鶏肉の皮は濃く焼き色がつき、ところどころ膨らんで、パリパリに焼けている……切り分けの途中で、片方の胸肉にはきれいに切り口が入っており、柔らかく湯気の立つ白身が、天然の肉汁をまとい、肉汁がボードに少し流れ出している……背景を柔らかくぼかした浅い被写界深度。」

デフォルトの fast 品質プリセットを使い、Gemini で生成しました。

反映された内容：

• for a recipe site：主題をひとつに絞り、ほかの要素はすべて控えめにしています
• actually cooked：膨らんだ皮、不均一な焼き色、立ち上る湯気、ナイフについた肉汁
• partway through being carved：片方の胸肉に切り口を入れ、切り分けた肉片は鳥の身に寄せたままにしています
• how juicy it is：ボードに流れ出す肉汁と、切り口の周囲の浅い被写界深度

プロンプトの最適化をオフにした場合の同じリクエストを比較する

プロンプトの最適化を無効にし、同じリクエストから生成したベースラインです。

SKIP_PROMPT_ENHANCEMENT=true を設定すると、元のプロンプトが変更されずに画像モデルへ送信されます。

クイックスタート

Node.js 22 以降、MCP 互換クライアント、いずれかの画像プロバイダーの API キーが必要です。

1. API キーを取得する

3 つのプロバイダーすべてで、画像の生成と編集ができます。Gemini はデフォルトで、最も簡単に設定できます。

Google 検索のグラウンディングを利用できるのは Gemini のみです。OpenAI で画像を生成するには、組織の認証が必要になる場合があります。

以下の例では Gemini を使用します。OpenAI または Seedream を使う場合は、プロバイダーの設定を置き換えてください。

2. MCP クライアントを設定する

Codex

~/.codex/config.toml に追加します：

[mcp_servers.mcp-image]
command = "npx"
args = ["-y", "mcp-image"]

[mcp_servers.mcp-image.env]
GEMINI_API_KEY = "your_gemini_api_key_here"
IMAGE_OUTPUT_DIR = "/absolute/path/to/images"

Cursor

すべてのプロジェクトに適用する場合は ~/.cursor/mcp.json に、プロジェクト内で設定する場合は .cursor/mcp.json に追加します：

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": ["-y", "mcp-image"],
      "env": {
        "GEMINI_API_KEY": "your_gemini_api_key_here",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Claude Code

プロジェクトディレクトリで次を実行します。

claude mcp add mcp-image --env GEMINI_API_KEY=your-api-key --env IMAGE_OUTPUT_DIR=/absolute/path/to/images -- npx -y mcp-image

すべてのプロジェクトで利用できるようにするには、mcp-image の後に --scope user を追加します。

API キーをバージョン管理にコミットしないでください。サーバーの作業ディレクトリはクライアントによって異なるため、MCP の設定では絶対パスの IMAGE_OUTPUT_DIR を使用してください。省略した場合、画像はその作業ディレクトリを基準とする ./output に書き込まれます。

3. 画像を生成する

設定を変更した後、MCP クライアントを再起動してから、AI アシスタントに次のように依頼します。

Generate a product photo of a ceramic coffee mug on a wooden desk.

生成されたファイルは、設定した出力ディレクトリに保存され、MCP リソースとしてアシスタントに返されます。

pnpm install
pnpm run build

node /absolute/path/to/mcp-image/dist/index.js

その他の例

既存の画像を編集する

ソース画像の絶対パスをアシスタントに指定します。

Edit /path/to/image.jpg so the person is facing right.

結果を調整する

• Generate a high-quality product photo of a smartphone with clear text on the screen.
• Generate a cinematic desert landscape in a 21:9 aspect ratio.
• Keep the knight's appearance consistent with the previous image.

アシスタントが明示的に指定できるオプションについては、ツールのリファレンスを参照してください。

設定

プロバイダーを変更すると、プロンプトの拡張と画像生成の両方が変わります。画像の依頼方法は変わりません。

品質

IMAGE_QUALITY には fast（デフォルト）、balanced、または quality を指定できます。MCP サーバーの環境で設定します。

IMAGE_QUALITY=balanced

アイデアを素早く試すには fast、日常的な用途には balanced、複雑なシーンや細部が重要な画像には quality を使用します。設定を高くすると時間とコストが増える場合があります。結果はプロバイダーによって異なります。

3 つのプロバイダーはいずれも、生成と編集でこれらのプリセットをサポートしています。各リクエストの quality オプションでデフォルトを上書きできます。

環境変数

複数のプロバイダーのキーを設定し、リクエストごとに切り替えることができます。リクエストレベルの provider オプションは IMAGE_PROVIDER より優先されます。

ツールリファレンス

MCP クライアントがこのツールを呼び出します。オプションやプロバイダーの制限を確認する必要がある場合は、リファレンスを開いてください。

トラブルシューティング

API キーが見つからない

選択したプロバイダーのキーが、MCP サーバーの環境に設定されていることを確認してください。

• Gemini：GEMINI_API_KEY
• OpenAI：OPENAI_API_KEY
• Seedream：ARK_API_KEY

設定を変更した後は、MCP クライアントを再起動してください。

入力画像ファイルが見つからない

絶対パスを使用し、MCP サーバーがファイルを読み取れることを確認してください。入力画像は PNG、JPEG、または WebP 形式で、各ファイルのサイズは 10 MiB 以下である必要があります。Seedream の編集でサポートされるのは PNG と JPEG のみです。

プロバイダーがリクエストを拒否する

プロバイダーの表で、リクエストしたサイズを確認してください。useGoogleSearch が使用できるのは Gemini のみで、Seedream は 4K をサポートしていません。OpenAI の権限エラーが発生した場合は、組織の設定を確認してください。クォータまたはレート制限のエラーが発生した場合は、選択したプロバイダーのアカウントを確認してください。

画像生成プロンプトスキル

このリポジトリには、画像生成ツールをすでに利用できるアシスタント向けの Agent Skill も含まれています。mcp-image が使用するプロンプト作成の手法を学べるもので、このサーバーとは独立して動作します。

次のコマンドでインストールします。

npx mcp-image skills install --path <skills-directory>

インストール先には、~/.codex/skills、~/.cursor/skills、または ~/.claude/skills を指定できます。

ライセンス

MIT License。詳細は LICENSE を参照してください。

お困りですか？Issue を作成するか、トラブルシューティングを確認してください。