用途:在支持 MCP 的客户端(如 Claude Code)中调用 Google Gemini 图像模型生成新图、编辑照片、制作带文字的图形,并管理生成历史。
主要能力:gemini_generate_image 按提示词生成图像;gemini_edit_image 按指令修改已有图像;continue_editing 对上一张图继续微调;get_image_history、search_history、get_image_by_id 用于查看与检索历史。模型可选 gemini-3-pro-image-preview(默认,质量最高、支持 4K)与 gemini-2.0-flash-exp 等。支持 4K 输出、图像内文字渲染、最多 14 张参考图合成、跨图角色一致性。生成结果保存在 ~/Documents/nanobanana_generated/,元数据写入 manifest.json,含提示词、模型、时间戳与编辑谱系。
使用方式:先获取 Gemini API Key,再配置 MCP 服务器。快速安装:claude mcp add nano-banana --env GEMINI_API_KEY=your-key-here -- npx -y nanobanana-mcp。也可在 ~/.claude/settings.json 中手动添加 mcpServers 配置。
适用场景:图像生成、照片编辑、信息图与示意图、社交媒体与演示素材、需要角色一致性的系列图。
限制:生成模型无法可靠渲染特定 logo、水印或清晰文字,品牌内容应先生成留白图像再手动叠加;可能出现手部或面部畸变、品牌色偏移、角色不一致;API 密钥需本地保管,避免提交到版本控制。