Image Gen3 Google MCP Server

🚀 双子星 Imagen 3.0 MCP サーバー

一款专业的模型上下文プロトコル（MCP）サーバー実装で、Google の Imagen 3.0 モデルと双子星 API を組み合わせて高品質な画像生成を行います。TypeScript で構築され、Claude Desktop やその他の MCP 互換ホストとのシームレスな統合を目的としています。

🚀 クイックスタート

前提条件

• Node.js 18 以上
• Google 双子星 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

✨ 主な機能

• Google の最新の Imagen 3.0 モデルを双子星 API 経由で利用
• 1 回のリクエストで最大 4 枚の高品質画像を生成
• スマートな命名付けを備えた自動ファイル管理
• HTML プレビュー生成と file:// プロトコルによるアクセスをサポート
• MCP プロトコルに基づく AI エージェント互換性
• TypeScript で実装され、強力なエラー処理能力を備える

⚙️ 設定

1. claude_desktop_config.json に設定を追加します：

{
  "mcpServers": {
    "gemini-image-gen": {
      "command": "node",
      "args": ["./build/index.js"],
      "cwd": "<プロジェクトディレクトリのパス>",
      "env": {
        "GEMINI_API_KEY": "あなたの双子星 API キー"
      }
    }
  }
}

2. プレースホルダーを置き換えます：
   • <プロジェクトディレクトリのパス>：あなたのプロジェクトのパス
   • あなたの双子星 API キー：あなたの双子星 API キー

🛠️ 利用可能なツール

1. generate_images

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

パラメータ：

• prompt（必須）：画像の説明テキスト
• numberOfImages（オプション）：生成する画像の数。デフォルトは 1。

2. view_logs

サーバーのログを表示します。

💻 使用例

基本的な使用法

# ターミナルで以下のコマンドを実行して画像を生成します
node generate_images.js --prompt "飛んでいる鳥" --numberOfImages 3

# ログを表示します
node view_logs.js

開発情報

プロジェクト構造

• src/: コアロジックとモジュールが含まれます。
• build/: ビルド後のファイルが保存されます。

実行時の依存関係

• Node.js：サーバーを実行するために使用されます。
• npm/yarn：依存関係を管理するために使用されます。

🤝 コントリビューションガイド

コントリビューションを歓迎します！開発への参加方法については CONTRIBUTING.md を参照してください。

⚠️ 重要提示

• API キーの安全を確保し、漏洩を避けてください。
• 本番環境では、必要に応じて適切なセキュリティ対策を設定してください。

📋 エラー処理

一般的なエラー

1. API 呼び出し失敗

   • ネットワーク接続と API キーが正しいか確認してください。
   • 詳細なエラー情報を取得するためにログを確認してください。

2. モジュールが見つからない

   • すべての依存関係が正しくインストールされていることを確認してください。
   • ファイルパスが正しいことを確認してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しています。詳細は LICENSE を参照してください。

💻 作者情報

連絡先

• メール：[あなたのメールアドレス]
• GitHub：[あなたの GitHub リンク]

謝辞

すべてのコントリビューターとオープンソースコミュニティのサポートに感謝します！

Falah G. Salih が愛情を込めて作成しました