使用说明
@maheidem/纳米香蕉mcp
用于谷歌Nano Banana图像生成模型(Gemini)的MCP服务器。通过Claude Code或任何MCP客户端的自然语言生成和编辑图像。
特性
- 文本到图像生成 具有可配置的型号、宽高比和分辨率(高达4K)
- 图像编辑 通过自然语言——添加/删除元素、风格转换、修复
- 迭代优化 --继续编辑上次生成的图像
- 3个模型层 --Flash(便宜),Pro(工作室质量),Flash 2(性价比最高)
- 仅文件路径 --响应中没有base64,防止上下文窗口溢出
- 持久模型偏好 --选择一次,随处使用
模型
| 型号 | ID | 状态 | 最大分辨率 | 价格/图像 |
|---|---|---|---|---|
| 纳米香蕉 | gemini-2.5-flash-image |
GA | 1千 | 0.039美元 |
| 纳米香蕉Pro | gemini-3-pro-image-preview |
预览 | 4K | 0.134美元-0.24美元 |
| 纳米香蕉2 | gemini-3.1-flash-image-preview |
预览 | 4K | 0.045美元-0.151美元 |
先决条件
- Node.js>=18
- 谷歌人工智能API密钥 已启用计费 (图像生成没有免费层)
- 把钥匙拿到 谷歌AI工作室
安装
克劳德代码(推荐)
claude mcp add nano-banana -e GEMINI_API_KEY=your-key -- npx --yes @maheidem/nanobanana-mcp
手册 .mcp.json
{
"mcpServers": {
"nano-banana": {
"command": "npx",
"args": ["@maheidem/nanobanana-mcp"],
"env": {
"GEMINI_API_KEY": "your-key"
}
}
}
}
工具
nb_generate_image
从文本提示生成新图像。
| 参数 | 必填 | 说明 |
|---|---|---|
prompt |
是 | 图像的文字描述 |
model |
否 | 型号ID(使用已保存的首选项) |
aspectRatio |
否 | 例如。 16:9, 1:1, 9:16 |
imageSize |
没有 | 512, 1K, 2K,或 4K |
outputDir |
否 | 保存目录(默认: NB_OUTPUT_DIR 或cwd) |
nb_edit_image
使用自然语言指令编辑现有图像。
| 参数 | 必填 | 说明 |
|---|---|---|
imagePath |
是 | 源图像的路径 |
prompt |
是 | 编辑说明 |
referenceImagePaths |
否 | 用于样式转换的参考图像 |
model |
否 | 型号ID |
aspectRatio |
否 | 输出纵横比 |
imageSize |
否 | 输出分辨率 |
outputDir |
否 | 保存目录 |
nb_continue_editing
继续编辑上次生成/编辑的图像。
| 参数 | 必填 | 说明 |
|---|---|---|
prompt |
是 | 新的编辑说明 |
model |
否 | 型号ID |
imageSize |
否 | 输出分辨率 |
outputDir |
否 | 保存目录 |
nb_get_last_image
获取有关上次生成/编辑的图像的元数据。没有API调用。
nb_list_models
列出可用型号并设置首选型号(持久化到磁盘)。
| 参数 | 必填 | 说明 |
|---|---|---|
setModel |
否 | 要另存为默认值的型号ID |
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
GEMINI_API_KEY |
是 | 谷歌人工智能API密钥(或 GOOGLE_API_KEY) |
NB_OUTPUT_DIR |
否 | 生成图像的默认输出目录 |
许可证
麻省理工学院