在 goose 中使用 Nano Banana MCP为 AI Agent 接入 Gemini 文生图与图像编辑能力【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/gooseNano Banana MCP Server 是一个基于 Google Gemini 图像模型Gemini 2.5 Flash Image的 MCP 服务器能够为 AI Agent 提供文生图与自然语言图像编辑两种核心能力。本指南讲解如何把它作为扩展接入 goose——一个开源、可扩展、可在任意 LLM 上安装、执行、编辑与测试的 AI Agent——使得 goose 不仅能读写代码还能直接画图你只需用自然语言描述需求goose 会自动把描述转写为高质量图像提示词并调用该服务器完成生成或迭代修改。阅读完本文你将掌握在 goose Desktop 与 CLI 两种界面下安装该扩展、配置GEMINI_API_KEY、验证配置以及通过对话指令完成从零生成、细节微调与风格改造的完整实战流程。扩展概览它给 goose 带来什么goose 的扩展机制建立在 Model Context ProtocolMCP 之上凡是遵循 MCP 标准的服务器都可以注册为 goose 扩展。Nano Banana MCP 正是这样一类能力型扩展文本转图像Text to Image把 goose 生成的自然语言提示词交给 Gemini 图像模型从零创作全新图片图像迭代编辑Image Editing / Iteration基于已有生成结果继续修改例如调整天空颜色、增加物体、删除文字、转换画风。从功能定位看它与内置的 Auto Visualiser自动数据可视化这类扩展不同Nano Banana 不是把已有数据变成图表而是面向设计稿、Logo、插画、概念图等视觉资产的生成与迭代适合把 goose 当成能动手画图的创意伙伴来使用。goose (自然语言请求) │ 把用户意图转写为详细提示词 ▼ nano-banana-mcp (MCP stdio 服务器通过 npx 启动) │ 调用 Google Gemini Image APIGEMINI_API_KEY ▼ 生成 / 编辑后的图片文件默认保存到 generated_imgs/ 目录安装前置条件在开始之前需要准备两样东西Node.jsNano Banana MCP 通过npx启动因此系统上必须先安装 Node.js。npx会在首次运行时自动拉取nano-banana-mcp这个 npm 包并执行无需手工 clone 仓库。Google Gemini API Key前往 Google AI Studio 的 API Keys 页面生成一个密钥用于调用 Gemini 图像模型。该密钥通过环境变量GEMINI_API_KEY提供给扩展进程配置项即GEMINI_API_KEY: YOUR_API_KEY:::note 关于密钥安全 无论使用哪种安装方式GEMINI_API_KEY都属于敏感凭据。直接编辑配置文件时建议保持该变量值的保密性goose 扩展进程以子进程方式运行时环境变量会被注入其运行环境中。 :::快速安装一行命令打通方式一goose Desktop 一键安装goose 支持通过goose://extension深链协议完成扩展的一键安装。在浏览器或桌面端触发下面的链接即可唤起 goose Desktop 的扩展安装流程goose://extension?cmdnpxargnano-banana-mcpidnano-banana-mcpnameNano%20BananadescriptionImage%20generation%20with%20Gemini深链中各参数含义为对应参数须做 URL 编码参数取值说明cmdnpx要执行的命令名goose 支持jbang/npx/uvx/goosed/docker等argnano-banana-mcp传给cmd的参数可重复出现拼接多个参数idnano-banana-mcp扩展的唯一标识nameNano Banana扩展在界面中显示的名称空格编码为%20descriptionImage generation with Gemini对扩展功能的简短描述方式二goose CLI / 会话内临时启用在命令行中Nano Banana MCP 的启动命令为npx nano-banana-mcp如果你想只在本会话临时启用、不写入常驻配置可以使用 goose CLI 的--with-extension参数在启动会话时直接指定扩展命令及其环境变量goose session --with-extension GEMINI_API_KEYYOUR_API_KEY npx nano-banana-mcp这种方式不会把扩展写入默认配置只对当前会话生效适合快速试用。完整配置三种主流方式详解在 goose Desktop 中配置点击窗口左上角的侧边栏按钮展开导航点击侧边栏中的Extensions在扩展列表区域点击Add custom extension在弹出的对话框中填写以下字段字段推荐取值说明TypeStandard IONano Banana 是本地 stdio 类型 MCP 服务器IDnano-banana-mcp扩展唯一标识可自定义NameNano Banana显示名称可自定义DescriptionImage generation with Gemini功能描述可自定义Commandnpx nano-banana-mcp要执行的完整命令Env VarsGEMINI_API_KEY 你的密钥点击Add逐项添加环境变量Timeout300秒goose 等待该扩展一次工具调用完成的最长时间其中 Timeout 字段值得特别留意图像生成属于耗时较长的推理任务官方推荐的超时时间为 300 秒5 分钟。如果设置过短较复杂的画面可能在生成完成前就被 goose 判定为超时。点击Add完成安装。通过 goose configure 交互式添加如果你习惯终端操作运行goose configure在交互菜单中依次选择Add Extension→Command-line Extension随后按提示输入◇ What would you like to call this extension? │ Nano Banana ◇ What command should be run? │ npx nano-banana-mcp ◇ Please set the timeout for this tool (in secs): │ 300 ◆ Would you like to add environment variables? │ Yes ◇ Environment variable name: │ GEMINI_API_KEY ◇ Environment variable value: │ YOUR_API_KEY ◇ Add another environment variable? │ No └ Added Nano Banana extension直接编辑配置文件对进阶用户goose 的所有扩展都持久化在配置文件例如 macOS 位于~/.config/goose/config.yaml中。可以在其中手工追加一个标准 IO 扩展条目extensions: nano-banana-mcp: name: Nano Banana description: Image generation with Gemini cmd: npx args: - nano-banana-mcp enabled: true envs: GEMINI_API_KEY: YOUR_API_KEY type: stdio timeout: 300该 YAML 结构可直接对照 goose 源码中的扩展配置模型理解在 crates/goose/src/acp/provider.rs 中ExtensionConfig枚举区分了Builtin、Platform、Stdio与StreamableHttp等类型其中Stdio分支正是承载cmd/args/envs/timeout这类字段的本地命令型扩展扩展的增删与启停则由 crates/goose/src/config/extensions.rs 模块set_extension、remove_extension、set_extension_enabled负责持久化与读取。在源码示例 crates/goose/examples/agent.rs 中还能看到同样的ExtensionConfig::stdio(...)编程式用法说明无论走配置文件还是直接调用 Rust API底层描述的是同一种 stdio 扩展结构。如果想在会话中途临时增删扩展goose 还提供了斜杠命令不会写入默认配置/extension npx nano-banana-mcp。需要彻底移除该扩展时先用goose configure的Toggle Extensions将其禁用再进入Remove Extension菜单完成删除。实战用自然语言驱动图像生成与编辑安装完成并配置好密钥后你可以在 goose 会话中直接提出图像需求。goose 的角色相当于提示词工程师——它会理解你的口语化描述将其润色成结构完整、细节丰富的英文图像提示词再调用 Nano Banana 完成创作。以下是官方指南展示的三类典型用法。从零创作Image Creation用一句话描述你想要的新画面Create an image of a sunset over mountainsGenerate a logo for a coffee shop called Bean ThereMake a fantasy dragon guarding a treasure hoard图像迭代Image Iteration每次生成完成后都可以基于当前图继续提出修改要求Nano Banana 会对同一张图做增量编辑Make the sky more purpleAdd a cat in the cornerRemove the textMake it more cartoon-style完整对话示例goose Promptuse nano banana to create an image of a fantasy ice mage crafting ice sculptures in a frozen workshopgoose Output摘录 Image generated with nano-banana (Gemini 2.5 Flash Image)! Prompt: A fantasy ice mage crafting ice sculptures in a frozen workshop. The mage wears flowing robes with frost patterns, their hands glowing with blue magical energy as they shape intricate ice sculptures. The workshop is filled with beautiful frozen creations - ice animals, crystalline flowers, and elaborate figurines. Icicles hang from the ceiling, frost covers the stone walls, and magical blue light illuminates the space. Snow gently drifts through the air. Detailed fantasy art style with magical atmosphere. ✨ Done! Heres your fantasy ice mage image!从该输出可以看到 goose 的实际工作链路它把一句口语化请求扩展为一整段详细场景描述 风格限定的完整提示词再由 nano-banana 生成。输出还会以列表形式回显画面中的核心元素角色造型、冰雕物品种类、场景氛围等并提示图片保存位置例如generated_imgs/generated-2025-12-04T04-15-47-907Z-3grhec.png生成结果示例如下图片来源由 nano-banana 依据上文提示词实际生成对话结尾 goose 还会主动询问是否继续修改并提示可使用continue_editing能力对画面做局部调整例如修改法师外观、增加更多雕塑、改变光照等——这正是前文图像迭代的自然延续无需重新生成整幅图。让多模态能力融入 Agent 工作流接入 Nano Banana 后图像能力不再是孤立的单次请求而可以与其他扩展协同形成闭环工作流与 Developer / Shell 能力配合goose 生成图片后可继续调用本地工具把generated_imgs/中的结果归档、重命名或批量检查输出目录与视觉理解类能力配合如果会话中还挂载了具备图像读取能力的模型或扩展生成后可让 goose审视成图质量并提出下一轮修改建议实现生成—审阅—迭代循环会话级与持久化扩展的选择临时试用可用--with-extension或/extension需要长期使用则建议走 Desktop 或goose configure写入默认配置避免每个新会话都要重新启用。常见问题与注意事项现象排查思路启动会话时报错找不到npx确认 Node.js 已安装且npx在 PATH 中Nano Banana 依赖 npx 拉包运行图像生成请求一直无结果或卡住检查 Timeout 是否过短图像生成任务较重建议保持 300 秒及以上的超时报错提示鉴权失败核对GEMINI_API_KEY是否正确、是否在扩展的环境变量中生效可先在 shell 中export GEMINI_API_KEY...后直接运行npx nano-banana-mcp自测图片保存位置默认生成于会话工作目录下的generated_imgs/注意查找该相对路径小结Nano Banana MCP 展示了 goose 扩展体系的强大扩展性通过标准的 MCP stdio 通道第三方工具型服务器图像、语音、搜索等可以无缝接入让 goose 从代码助手扩展为能画图、能创作的多模态 Agent。核心要点可归纳为三点安装上使用npx nano-banana-mcpGEMINI_API_KEY即可打通配置上记得为图像生成这类长耗时任务保留足够的 timeout使用上 goose 会自动完成口语化需求 → 专业图像提示词的转换并支持continue_editing式的持续迭代你只需要用自然语言描述画面即可。若想深入了解 goose 的扩展机制可继续阅读 Using Extensions 指南 及其余 MCP 扩展教程。【免费下载链接】goosean open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM项目地址: https://gitcode.com/GitHub_Trending/goose3/goose创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考