MCP Nano Banana

🚀 MCP Nano Banana

このプロジェクトは、Google Gemini APIを使用して画像を生成するMCP（Model Context Protocol）サーバーです。

✨ 主な機能

このサーバーは、Model Context Protocolを実装し、互換性のあるAIモデルに単一のツール generate_image を公開します。このツールはテキストプロンプトを受け取り、Google Gemini APIを使用して画像を生成し、画像を監査用に public/ ディレクトリに保存し、生の画像データをBase64エンコードされた文字列として返します。

🚀 クイックスタート

Claude Desktopや他のアプリケーションでこのサーバーを使用するには、Google Gemini APIキーとImgBB APIキーが必要です。

https://api.imgbb.com/ にアクセスして、IMGBB APIキーを生成します。これは画像をオンラインで保存およびホストするために使用されます。

{
  "mcpServers": {
    "mcp-nano-banana": {
        "command": "uvx",
        "args": [
            "mcp-nano-banana"
        ],
        "env": {
            "GEMINI_API_KEY": "YOUR_API_KEY_HERE",
            "IMGBB_API_KEY": "YOUR_API_KEY_HERE"
        }
    }
  }
}

📦 インストール

1. 依存関係

このプロジェクトはPythonを使用しており、その依存関係は pyproject.toml で定義されています。pip を使用してインストールできます。

pip install .
# または
uv sync

これにより、mcp、google-generativeai、およびその他の必要なパッケージがインストールされます。

2. APIキー

このサーバーを使用するには、Google Gemini APIキーとImgBB APIキーが必要です。

https://api.imgbb.com/ にアクセスして、IMGBB APIキーを生成します。これは画像をオンラインで保存およびホストするために使用されます。

1. プロジェクトのルートに .env という名前のファイルを作成します。
2. 次の形式でAPIキーを .env ファイルに追加します。

    GEMINI_API_KEY="YOUR_API_KEY_HERE"
    IMGBB_API_KEY="YOUR_API_KEY_HERE"

💻 使用例

基本的な使用法

このサーバーは、MCPクライアントによってサブプロセスとして実行されるか、mcp コマンドラインツールを使用して実行するように設計されています。サーバーは stdio でリクエストを待ち受けます。

uvx --from git+https://github.com/GuilhermeAumo/mcp-nano-banana mcp-nano-banana

📚 ドキュメント

PyPIへの新しいバージョンの公開

このパッケージの新しいバージョンをPyPIに公開するには、次の手順を実行します。

1. バージョンの更新
   pyproject.toml の version フィールドを新しいバージョン番号に編集します。

2. パッケージのビルド
   次のコマンドを実行します。

   uv build
   

   これにより、dist/ ディレクトリに .tar.gz と .whl ファイルが作成されます。

3. PyPIへのアップロード

   uv publish
   

4. リリースのタグ付け（オプションだが推奨）
   まず変更をgithubにコミットしてから、次のコマンドを実行します。

   git tag v<new-version>
   git push --tags
   

⚠️ 重要提示

PyPIアカウントが必要で、プロジェクトのメンテナとして登録されている必要があります。

詳細については、Python Packaging User Guide を参照してください。