Gemini Imagen 3.0 MCP Server

Gemini Imagen 3.0 MCP サーバー

Gemini API を通じて Google の Imagen 3.0 モデルを活用し、高品質な画像を生成する、プロフェッショナル向けの Model Context Protocol（MCP）サーバー実装です。TypeScript で構築されており、Claude Desktop やその他の MCP 対応ホストとスムーズに連携できるよう設計されています。

🌟 特長

• Gemini API 経由で Google の最先端 Imagen 3.0 モデルを活用
• 1 回のリクエストで最大 4 枚の高品質な画像を生成
• インテリジェントな命名によるファイル管理の自動化
• file:// プロトコルに対応した HTML プレビューの生成
• AI エージェントとの互換性を実現する MCP プロトコルに基づいて構築
• 堅牢なエラー処理を備えた TypeScript 実装

🚀 クイックスタート

前提条件

• Node.js 18 以降
• Google Gemini API キー
• Claude Desktop またはその他の MCP 対応ホスト

インストール

1. リポジトリをクローンします：

git clone https://github.com/yourusername/gemini-imagen-mcp-server.git
cd gemini-imagen-mcp-server

2. 依存関係をインストールします：

npm install

3. TypeScript コードをビルドします：

npm run build

⚙️ 設定

1. claude_desktop_config.json に追加して、Claude Desktop を設定します：

{
  "mcpServers": {
    "gemini-image-gen": {
      "command": "node",
      "args": ["./build/index.js"],
      "cwd": "<path-to-project-directory>",
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key"
      }
    }
  }
}

2. プレースホルダーを置き換えます：
   • <path-to-project-directory>：プロジェクトのパス
   • your-gemini-api-key：Gemini API キー

🛠️ 利用可能なツール

1. generate_images

Google の Imagen 3.0 モデルを使用して画像を生成します。

パラメーター：

• prompt（必須）：生成する画像のテキストによる説明
• numberOfImages（省略可）：画像の枚数（1～4、デフォルト：1）

ファイル管理：

• 画像は G:\image-gen3-google-mcp-server\images に自動的に保存されます
• ファイル名は次の形式になります：{sanitized-prompt}-{timestamp}-{index}.png
• タイムスタンプにより、一意のファイル名が保証されます
• プロンプトはファイルシステムで安全に使用できるようにサニタイズされます

例：

Generate an image of a futuristic city at night

2. create_image_html

生成した画像の HTML プレビュータグを作成します。

パラメーター：

• imagePaths（必須）：画像ファイルパスの配列
• width（省略可）：画像の幅（ピクセル単位、デフォルト：512）
• height（省略可）：画像の高さ（ピクセル単位、デフォルト：512）

ローカルで表示するための、絶対パスを含む file:// URL の HTML タグを返します。

例：

Create HTML tags for the generated images with width=400

🔧 開発

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run tests (when available)
npm test

🤝 貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。大きな変更を行う場合は、次の手順に従ってください：

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/AmazingFeature）
3. 変更をコミットします（git commit -m 'Add some AmazingFeature'）
4. ブランチにプッシュします（git push origin feature/AmazingFeature）
5. プルリクエストを作成します

📝 エラー処理

このサーバーでは、主に次の 2 つのエラーコードを使用します：

• tool_not_found（1）：要求されたツールが利用できない場合
• execution_error（2）：画像の生成または HTML の作成に失敗した場合

📄 ライセンス

MIT ライセンスの詳細については、LICENSE ファイルをご覧ください。

✨ 作者

Falah G. Salieh

• 著作権 © 2025
• GitHub： @yourgithubhandle
• メール：[email protected]

🙏 謝辞

• Google Gemini API と Imagen 3.0 モデル
• Anthropic による Model Context Protocol（MCP）
• MCP ホスト実装を提供する Claude Desktop チーム

📌 タグ

#MCP #Gemini #Imagen3 #AI #ImageGeneration #TypeScript #NodeJS #GoogleAI #ClaudeDesktop

---

Falah G. Salieh が ❤️ を込めて作成