🚀 Banana Image MCP

Banana Image MCPは、Claudeや他のAIアシスタントがGoogleの最新Gemini画像モデルを使用して高品質な画像を生成できる、本番環境で使用可能なMCP (Model Context Protocol)サーバーです。あなたが何を望むかを簡単に説明するだけで、Claudeがそれを作成します。素早いコンセプトスケッチから見事な4Kのプロフェッショナルなアートワークまで、あらゆるものを生成できます。

🚀 クイックスタート

2分以内でセットアップして動作を開始できます。

前提条件

• Google AI Studioから無料のGemini APIキーを取得します。
• Claude Desktopをインストールします。

インストール

Claude Desktopの設定ファイルに追加します：

{
  "mcpServers": {
    "banana-image": {
      "command": "uvx",
      "args": ["banana-image-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

# このパッケージのキャッシュをクリアします
uv cache clean banana-image-mcp

# その後、Claude Desktopを再起動します

"args": ["banana-image-mcp==1.0.1"]

✨ 主な機能

4K Ultra HD出力

Proモデルを使用すると、最大3840pxの画像を生成できます。プロフェッショナルな作品、マーケティング素材、印刷可能なアセットに最適です。

デュアルモデルサポート

• Flash：2 - 3秒、最大1024px — 素早い反復作業に最適
• Pro：5 - 8秒、最大4K — 最終的な成果物に最適

スマートモデル選択

サーバーはあなたのプロンプトに基づいて最適なモデルを自動的に選択します。「quick sketch」と言えばFlashモデルが選択され、「4K professional」と言えばProモデルが選択されます。

Google検索ベースの生成

ProモデルはGoogle検索の実世界の知識を使用して、より正確で事実に基づいた画像を生成します。

柔軟なアスペクト比

1:1, 16:9, 9:16, 4:3, 3:2, 21:9など、すべての一般的なアスペクト比をサポートしています。

自然言語による画像編集

「make the sky more dramatic」や「remove the background」のような簡単なテキストコマンドで既存の画像を編集できます。

💻 使用例

Claudeに自然に画像生成を依頼するだけです：

"可愛い宇宙服を着た猫を生成して"

"4K品質のコーヒーカップのプロフェッショナルな製品写真を作成して"

"料理に関する16:9のYouTubeサムネイルを作成して"

"この画像を編集して、空をもっと劇的にして"

モデル比較

サーバーはデフォルトで最高品質のProモデルを使用します。キーワードで制御することができます：

パラメーターリファレンス

環境変数

📚 ドキュメント

作成できるもの

ロードマップ

• [x] 4K解像度出力 (最大3840px)
• [x] デュアルモデルサポート (Flash + Pro)
• [x] Google検索ベースの生成
• [x] 柔軟なアスペクト比
• [x] 自然言語による画像編集
• [x] GitHub Actions CI/CD
• [ ] バッチ画像生成
• [ ] 画像から画像への変換
• [ ] ビデオ生成サポート
• [ ] ローカルモデルサポート (Ollama)

詳細な提案機能と既知の問題のリストは、オープンイシューを参照してください。

🔧 技術詳細

# リポジトリをクローンします
git clone https://github.com/zengwenliang416/banana-image-mcp.git
cd banana-image-mcp

# 依存関係をインストールします
uv sync

# 開発モードで実行します
fastmcp dev banana_image_mcp.server:create_app

# テストを実行します
pytest

# リントとフォーマットを行います
ruff check .
ruff format .

🤝 コントリビュート

コントリビューションによってオープンソースコミュニティは素晴らしいものになります。あなたのコントリビューションは大いに歓迎されます。

1. プロジェクトをフォークします。
2. あなたの機能ブランチを作成します (git checkout -b feature/AmazingFeature)。
3. 変更をコミットします (git commit -m 'Add some AmazingFeature')。
4. ブランチにプッシュします (git push origin feature/AmazingFeature)。
5. プルリクエストを作成します。

📄 ライセンス

このプロジェクトはMITライセンスの下で配布されています。詳細はLICENSEを参照してください。

📞 お問い合わせ

Zeng Wenliang - @zengwenliang416

プロジェクトのリンク: https://github.com/zengwenliang416/banana-image-mcp

🙏 謝辞

• FastMCP - このサーバーを支えるMCPフレームワーク
• Google Gemini - 画像生成の背後にあるAIモデル
• Anthropic MCP - プロトコル仕様
• Best-README-Template - READMEのインスピレーション