使用说明
Nano Banana MCP
MCP server for Google Gemini image generation with configurable model support.
Features • Setup • Models • Tools
Website • YouTube • Skool Community
这是什么?
叉子 纳米香蕉mcp 有一个关键的升级: 可配置模型选择 通过环境变量。
原始包硬编码 gemini-2.5-flash-image-preview (2026年1月关闭)。此分叉默认为 gemini-3.1-flash-image-preview 并允许您在不接触代码的情况下交换模型。
特性
- 根据文本提示生成图像
- 使用自然语言编辑现有图像
- 迭代编辑(继续细化最后一张图像)
- 多图像参考支持(样式转换、组合元素)
- 可配置纵横比 (1:1、16:9、9:16、3:2、2:3、4:3、3:4、4:5、5:4、21:9等)
- 可通过以下方式配置Gemini模型
GEMINI_MODELenv 是
设置
克劳德代码/光标
添加到您的 .mcp.json:
{
"mcpServers": {
"nano-banana": {
"type": "stdio",
"command": "node",
"args": ["/path/to/nanobanana-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "your-api-key-here",
"GEMINI_MODEL": "gemini-3.1-flash-image-preview"
}
}
}
}
再进行
git clone https://github.com/charlesdove977/nanobanana-mcp.git
cd nanobanana-mcp
npm install
获取Gemini API密钥
- 首选 谷歌人工智能工作室
- 创建新的API密钥
- 将其添加到MCP配置中
GEMINI_API_KEY
模型
集 GEMINI_MODEL 在您的env中添加以下任何一项(或省略它以使用默认值):
| 型号ID | 等级 | 价格 | 最适合 |
|---|---|---|---|
gemini-3.1-flash-image-preview |
Flash(默认) | ~0.045/img | 速度+质量平衡 |
gemini-3-pro-image-preview |
Pro | 约0.134/img美元 | 最高质量、最佳文本渲染 |
gemini-2.5-flash-image |
传统闪存 | ~0.039/img | 预算,大容量 |
所有模型都支持通过同一个API生成和编辑。
工具
| 工具 | 说明 |
|---|---|
generate_image |
从文本提示创建新图像(可选 aspectRatio) |
edit_image |
使用提示修改现有图像文件(可选 aspectRatio) |
continue_editing |
继续优化上次生成/编辑的图像(可选 aspectRatio) |
get_last_image_info |
检查最后一张图像的路径和大小 |
configure_gemini_token |
在运行时设置API密钥 |
get_configuration_status |
检查是否配置了API密钥 |
宽高比
所有图像工具都接受可选 aspectRatio 参数。支持的值:
1:1 2:3 3:2 3:4 4:3 4:5 5:4 9:16 16:9 21:9 1:4 1:8 4:1 8:1
例子
生成(默认1:1):
“夕阳下的未来城市天际线,有飞行汽车”
生成(16:9宽屏):
提示:“日落时分,未来城市天际线与飞行汽车”,aspectRatio:“16:9”
编辑:
编辑
photo.png:“删除背景并替换为渐变”
继续编辑:
“使颜色更加鲜艳,并添加镜头光斑”
图像存储
生成的图像保存到 ./generated_imgs/ 在您的工作目录(macOS/Linux)中,或 ~/Documents/nano-banana-images/ (Windows)。
学分
分叉自 ConechoAI/纳米香蕉MCP。更新了可配置的模型支持和最新的Gemini模型。
许可证
麻省理工学院