@your-scope/ai-studio-image-mcp

MCP server for image generation / simple edit using Gemini 2.5 Flash Image (AI Studio / API key only).
Imagen や Vertex AI は完全に非対応です。AI Studio の APIキーを使って、Claude Code から手軽に画像生成／編集ができます。

Requirements

• Node.js 18+
• Claude CLI（最新推奨）
• @google/genai 0.11+ / @modelcontextprotocol/sdk 1.17+

🚀 Quick Start — AI Studio (Developer API 専用)

1) APIキーを取得

• Google AI Studio にログイン
• APIキーを発行
• ローカル環境に設定

  $env:GOOGLE_API_KEY="AIza..."

2) Claude へ登録（npx 経由）

claude mcp add genai-image `
  npx @your-scope/ai-studio-image-mcp `
  -s user `
  -e GOOGLE_API_KEY=$env:GOOGLE_API_KEY

環境変数 GOOGLE_GENAI_USE_VERTEXAI や GOOGLE_CLOUD_PROJECT 等は不要です。

Tools（引数サンプル）

1) genai_generate_image（画像生成）

{
  "prompt": "美しい夕日、オレンジと紫のグラデーション、穏やかな海、地平線に沈む太陽、写実的、高品質",
  "model": "gemini-2.5-flash-image-preview",
  "output_mime_type": "image/png",
  "save_to_file": true,
  "filename_prefix": "sunset"
}

• model は省略可（既定: gemini-2.5-flash-image-preview）
• 生成画像は MCP の Base64 として返り、save_to_file: true を指定すると ./out/ にも保存されます。

2) genai_inpaint_image（簡易編集）

{
  "prompt": "中央の人物を赤い傘を持った人に変更してください",
  "base_image_base64": "<元画像base64（data URL可）>",
  "model": "gemini-2.5-flash-image-preview",
  "output_mime_type": "image/png",
  "save_to_file": true,
  "filename_prefix": "edit"
}

• マスク編集やアップスケールは非対応です。
• 自然言語＋ベース画像1枚で簡易的な置き換えや修正が可能です。

Troubleshooting

• Missing GOOGLE_API_KEY
  → 環境変数 GOOGLE_API_KEY が設定されていません。
• 404 models/... not found
  → Vertex用の環境変数 (GOOGLE_GENAI_USE_VERTEXAI, GOOGLE_CLOUD_PROJECT) が残っていないか確認してください。AI Studio専用版では不要です。
• 生成結果が無い
  → プロンプトを調整してください。saved: の行が出力されない場合はモデル応答が空です。

開発者向け（ローカル起動）

npm install
npm run build
node dist/server.js

License

MIT