Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NO_PROXY | No | Hosts to exclude from proxy (e.g., 127.0.0.1,localhost) | |
| LOG_LEVEL | No | Logging level: DEBUG, INFO, WARNING, ERROR | INFO |
| GCP_REGION | No | Google Cloud region for Vertex AI | us-central1 |
| LOG_FORMAT | No | Log format: standard, json, or detailed | standard |
| GCP_PROJECT_ID | No | Your Google Cloud project ID (required for Vertex AI authentication) | |
| GEMINI_API_KEY | No | Your Gemini API key for authentication | |
| CLIPROXY_CONFIG | No | Path to CLIProxyAPI config.yaml file | |
| CLIPROXY_API_KEY | No | API key for CLIProxyAPI authentication | |
| IMAGE_OUTPUT_DIR | No | Directory path for saving generated images | ~/nanobanana-images |
| NANOBANANA_MODEL | No | Model selection: 'flash', 'pro', or 'auto' | auto |
| CLIPROXY_BASE_URL | No | Base URL for CLIProxyAPI (e.g., http://127.0.0.1:8318) | |
| NANOBANANA_AUTH_METHOD | No | Authentication method: 'api_key', 'vertex_ai', or 'auto' (default: auto) | auto |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_image | Generate new images or edit existing images using natural language instructions. Supports multiple input modes:
Automatically detects mode based on parameters or can be explicitly controlled. Input images are read from the local filesystem to avoid massive token usage. Returns both MCP image content blocks and structured JSON with metadata. |
| upload_file | Upload a local file through the Gemini Files API and return its URI & metadata. Useful when the image is larger than 20MB or reused across prompts. |
| show_output_stats | Show statistics about the output directory and recently generated images. |
| maintenance | Perform maintenance operations following workflows.md patterns. Available operations:
|
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| photorealistic_shot | Generate a prompt for high-quality photorealistic images. |
| logo_text | Generate a prompt for logo creation with accurate text rendering. |
| product_shot | Generate a prompt for studio product photography. |
| sticker_flat | Generate a prompt for flat/kawaii style stickers. |
| iterative_edit_instruction | Generate an instruction for precise image editing. |
| composition_and_style_transfer | Generate an instruction for style transfer and composition blending. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| prompt_templates_catalog | A compact catalog of prompt templates (same schemas as the @mcp.prompt items). |
| list_operations | List all tracked operations. Returns: Dict with list of operations and summary statistics |