English Français العربية

io.github.fjacquet/nano-banana-mcp

السجل الرسمي الوسائط والتصميم

AI image generation and editing with Google Gemini: Nano Banana 2.1, Pro and Lite models

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @fjacquet/nano-banana-mcp
Claude Code 
claude mcp add nano-banana-mcp -e 'GEMINI_API_KEY=<your gemini_api_key>' -- npx -y @fjacquet/nano-banana-mcp@3.2.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "nano-banana-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@fjacquet/nano-banana-mcp@3.2.1"
            ],
            "env": {
                "GEMINI_API_KEY": "<your gemini_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • GEMINI_API_KEY سري Gemini API key from Google AI Studio. Optional: it can also be set later with the configure_gemini_token tool.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Nano-Banana MCP Server
  2. Quick Start
  3. Tools
  4. Development
  5. License

Nano-Banana MCP Server

An MCP server for AI image generation and editing using Google Gemini. Works with Claude Code, Cursor, and other MCP clients.

Models supported:

Brand nameModel IDNotes
Nano Banana 2.1gemini-nano-banana-2.1Default — pro quality at Flash speed
Nano Banana Progemini-3-pro-imageHighest quality, advanced reasoning
Nano Banana 2gemini-3.1-flash-imagePrevious default
Nano Banana 2 Litegemini-3.1-flash-lite-imageFastest and cheapest — 1K output only
Nano Bananagemini-2.5-flash-imageLegacy — shut down by Google on 2027-03-15

Quick Start

  1. Get a Gemini API key from Google AI Studio
  2. Add to your MCP client config (Claude Code example): json { "mcpServers": { "nano-banana": { "command": "npx", "args": ["-y", "github:fjacquet/Nano-Banana-MCP"], "env": { "GEMINI_API_KEY": "your-key-here" } } } }

See docs/configuration.md for Cursor and other MCP clients.

  1. Use the tools: 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

Tools

ToolDescription
generate_imageCreate new images from text prompts
edit_imageModify existing images with optional reference images
continue_editingIteratively edit the last image
get_last_image_infoGet info about the last image
configure_gemini_tokenSet API key
get_configuration_statusCheck configuration

All generation/editing tools accept an optional model parameter to choose between the two models.

See docs/tools.md for full API reference, docs/configuration.md for setup details, and docs/workflows.md for usage patterns.

Development

npm install
npm run dev          # Run with tsx
npm run build        # Compile TypeScript
npm test             # Run tests
npm run lint         # Lint
npm run typecheck    # Type-check

Requires Node.js >= 18.0.0.

License

MIT — see LICENSE.

Fork of ConechoAI/Nano-Banana-MCP.

الأسئلة الشائعة

ما هو io.github.fjacquet/nano-banana-mcp؟

AI image generation and editing with Google Gemini: Nano Banana 2.1, Pro and Lite models

كيف أثبّت io.github.fjacquet/nano-banana-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add nano-banana-mcp -e 'GEMINI_API_KEY=<your gemini_api_key>' -- npx -y @fjacquet/nano-banana-mcp@3.2.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.fjacquet/nano-banana-mcp إلى مفتاح API؟

نعم. يتطلب GEMINI_API_KEY، وتضبطها في إعداداته.

هل io.github.fjacquet/nano-banana-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.fjacquet/nano-banana-mcp؟

ينشره fjacquet. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.