Nano Banana Mcp

Nano-Banana MCP サーバー 🍌

🤖 このプロジェクトは Claude Code によって完全に生成されました - AI コーディングアシスタントであり、完全で実運用可能なアプリケーションをゼロから作成できます。

Google の Gemini 2.5 Flash Image API を使用して AI 画像生成および編集機能を提供する Model Context Protocol（MCP）サーバーです。シンプルなテキストプロンプトで、驚くような画像を生成し、既存の画像を編集し、作成したものを繰り返し改善できます。

✨ 機能

• 🎨 画像を生成: テキストの説明から新しい画像を作成します
• ✏️ 画像を編集: テキストプロンプトで既存の画像を変更します
• 🔄 反復編集: 最後に生成または編集した画像の編集を続行します
• 🖼️ 複数の参照画像: スタイル転送やガイダンスのために参照画像を使用します
• 🌍 クロスプラットフォーム: Windows、macOS、Linux 向けのスマートなファイルパス
• 🔧 簡単セットアップ: API キーによるシンプルな設定
• 📁 自動ファイル管理: 整理された命名による画像の自動保存

🔑 セットアップ

1. Gemini API キーを取得する:

   • Google AI Studio にアクセスします
   • 新しい API キーを作成します
   • 設定のためにコピーします

2. MCP サーバーを設定する: 以下のお使いのクライアント（Claude Code、Cursor、その他の MCP クライアント）向けの設定例を参照してください。

💻 Claude Code での使用

設定:

Claude Code の MCP 設定に以下を追加します:

オプション A: 環境変数を使用する場合（推奨 - 最も安全）

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["nano-banana-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    }
  }
}

オプション B: 環境変数を使用しない場合

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["nano-banana-mcp"]
    }
  }
}

使用例:

Generate an image of a sunset over mountains

Edit this image to add some birds in the sky

Continue editing to make it more dramatic

🎯 Cursor での使用

設定:

Cursor の MCP 設定に追加します:

オプション A: 環境変数を使用する場合（推奨）

{
  "nano-banana": {
    "command": "npx",
    "args": ["nano-banana-mcp"],
    "env": {
      "GEMINI_API_KEY": "your-gemini-api-key-here"
    }
  }
}

オプション B: 環境変数を使用しない場合

{
  "nano-banana": {
    "command": "npx",
    "args": ["nano-banana-mcp"]
  }
}

使用例:

• Cursor にアプリ用の画像を生成するよう依頼する
• モックアップやプロトタイプを作成する
• プロジェクト用のアセットを生成する

🔧 その他の MCP クライアント向け

別の MCP クライアントを使用している場合は、以下のいずれかの方法で nano-banana-mcp を設定できます:

設定方法

方法 A: MCP 設定内の環境変数（推奨）

{
  "nano-banana": {
    "command": "npx",
    "args": ["nano-banana-mcp"],
    "env": {
      "GEMINI_API_KEY": "your-gemini-api-key-here"
    }
  }
}

方法 B: システム環境変数

export GEMINI_API_KEY="your-gemini-api-key-here"
npx nano-banana-mcp

方法 C: Configure ツールを使用する

npx nano-banana-mcp
# The server will prompt you to configure when first used
# This creates a local .nano-banana-config.json file

🛠️ 利用可能なコマンド

generate_image

テキストプロンプトから新しい画像を作成します。

generate_image({
  prompt: "A futuristic city at night with neon lights"
})

edit_image

特定の画像ファイルを編集します。

edit_image({
  imagePath: "/path/to/image.png",
  prompt: "Add a rainbow in the sky",
  referenceImages?: ["/path/to/reference.jpg"] // optional
})

continue_editing

最後に生成または編集した画像の編集を続行します。

continue_editing({
  prompt: "Make it more colorful",
  referenceImages?: ["/path/to/style.jpg"] // optional
})

get_last_image_info

最後に生成した画像に関する情報を取得します。

get_last_image_info()

configure_gemini_token

Gemini API キーを設定します。

configure_gemini_token({
  apiKey: "your-gemini-api-key"
})

get_configuration_status

API キーが設定されているかを確認します。

get_configuration_status()

⚙️ 設定の優先順位

MCP サーバーは、以下の優先順位で API キーを読み込みます:

1. 🥇 MCP 設定の環境変数（最優先）

   • claude_desktop_config.json または MCP クライアントの設定で設定します
   • MCP 設定内に含まれるため最も安全です
   • 例: "env": { "GEMINI_API_KEY": "your-key" }

2. 🥈 システム環境変数

   • シェルまたはシステムの環境で設定します
   • 例: export GEMINI_API_KEY="your-key"

3. 🥉 ローカル設定ファイル（最低優先）

   • configure_gemini_token ツールを使用すると作成されます
   • 現在のディレクトリに .nano-banana-config.json として保存されます
   • Git および NPM によって自動的に無視されます

💡 推奨: 最高のセキュリティと利便性のために、方法 1（MCP 設定の環境変数）を使用してください。

📁 ファイルストレージ

画像はプラットフォームに適した場所へ自動的に保存されます:

• Windows: %USERPROFILE%\\Documents\\nano-banana-images\\
• macOS/Linux: ./generated_imgs/ (カレントディレクトリ内)
• システムディレクトリ: ~/nano-banana-images/ (システムパスから実行した場合)

ファイル命名規則:

• 生成された画像: generated-[timestamp]-[id].png
• 編集された画像: edited-[timestamp]-[id].png

🎨 ワークフローの例

基本的な画像生成

1. generate_image - ベースとなる画像を作成します
2. continue_editing - 洗練させて改善します
3. continue_editing - 最後の仕上げを加えます

スタイル転送

1. generate_image - ベースとなるコンテンツを作成します
2. edit_image - 参照画像を使ってスタイルを適用します
3. continue_editing - 結果を微調整します

反復的なデザイン

1. generate_image - コンセプトから始めます
2. get_last_image_info - 現在の状態を確認します
3. continue_editing - 調整を行います
4. 満足するまで繰り返します

🔧 開発

このプロジェクトは Claude Code で作成され、以下の技術を使用しています:

• TypeScript - 型安全な開発
• Node.js - ランタイム環境
• Zod - スキーマ検証
• Google GenAI - 画像生成 API
• MCP SDK - Model Context Protocol

ローカル開発

# Clone the repository
git clone https://github.com/claude-code/nano-banana-mcp.git
cd nano-banana-mcp

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npm test

📋 要件

• Node.js 18.0.0 以上
• Google AI Studio の Gemini API キー
• Claude Code、Cursor、その他の MCP クライアントと互換性があります

🤝 コントリビューション

このプロジェクトは Claude Code によって生成されましたが、コントリビューションを歓迎します！ぜひ以下のことをお願いします:

• バグの報告
• 新機能の提案
• プルリクエストの送信
• ドキュメントの改善

📄 ライセンス

MIT License - 詳細は LICENSE ファイルをご覧ください。

🙏 謝辞

• Claude Code - このプロジェクト全体を生成してくれたことに感謝します
• Google AI - 強力な Gemini 2.5 Flash Image API に感謝します
• Anthropic - Model Context Protocol に感謝します
• オープンソースコミュニティ - 素晴らしいツールとライブラリに感謝します

📞 サポート

• 🐛 Issues: GitHub Issues
• 📖 ドキュメント: この README とインラインコードコメント
• 💬 ディスカッション: GitHub Discussions

---

✨ Claude Code によって心を込めて生成されました - AI を活用した開発の未来がここにあります！