Nano Banana-OpenRouter MCP服务器
为MCP快速、经济高效地生成和编辑图像。由Nano Banana 2通过OpenRouter提供支持。
特性
- 编辑或创建图像:在OpenRouter上使用Nano Banana 2模型创建或编辑图像。快速、经济高效的结果。最多支持12个上下文图像。默认情况下保存到项目文件夹。
- 批编辑或创建图像:在单个批处理中执行多个图像创建或编辑任务。针对Nano Banana 2进行了优化。非常适合快速、经济高效的创意工作流程。
- 健康检查:验证
.env加载、API密钥存在、所选模型,以及可选地运行实时OpenRouter连接测试。 - 开始_通知:打开可视化注释UI,在编辑前在图像上绘制并添加注释。
- get_annotation_results:在用户单击“完成”后检索已完成的注释结果。
- 完成_注释_编辑:一个步骤助手,检索完成的注释并立即应用请求的编辑。
- 多模式支持:提供多达12幅本地图像作为编辑或灵感的背景。
- 灵活的输出:指定保存每个生成图像的本地路径。
- 模型覆盖:仍然支持
NANO_BANANA_MODEL_ID如果您想将服务器指向不同的OpenRouter映像模型。
设置
先决条件
- 安装了Node.js和npm。
- 一 开放路由 API密钥。
安装
- 克隆此存储库:
git clone https://github.com/BearThreat/nano-banana-openrouter-mcp
cd nano-banana-openrouter-mcp- 安装依赖项:
npm install- 构建服务器:
npm run build配置
将服务器添加到MCP设置文件中(例如。, cline_mcp_settings.json 或 claude_desktop_config.json):
{
"mcpServers": {
"nano-banana": {
"command": "node",
"args": ["/path/to/nano-banana-openrouter-mcp/build/index.js"],
"cwd": "/path/to/nano-banana-openrouter-mcp",
"env": {
"OPENROUTER_API_KEY": "your-openrouter-api-key",
"NANO_BANANA_MODEL_ID": "google/gemini-3.1-flash-image-preview"
},
"disabled": false,
"autoApprove": [
"edit_or_create_image",
"batch_edit_or_create_images",
"start_annotation",
"get_annotation_results",
"complete_annotation_edit",
"health_check"
]
}
}
}用法
配置后,您的AI客户端将可以访问图像生成工具。
默认情况下,此服务器现在的目标是 纳米香蕉2 在OpenRouter上:
google/gemini-3.1-flash-image-preview
这是为了更好地权衡速度/成本而选择的。您仍然可以用以下命令覆盖它 NANO_BANANA_MODEL_ID 如果需要的话。
单幅图像生成
{
"prompt": "Generate a modern technical infographic about the Model Context Protocol.",
"outputPath": "infographic.png"
}批量图像生成
{
"tasks": [
{ "prompt": "Create a blue circle", "outputPath": "circle.png" },
{ "prompt": "Create a red square", "outputPath": "square.png" },
{ "prompt": "Combine circle.png and square.png into a single composition", "imagePaths": ["circle.png", "square.png"], "outputPath": "combined.png" }
]
}图像标注
使用 start_annotation 工具打开基于浏览器的注释UI,您可以在图像上徒手绘制标记并添加注释:
{
"imagePaths": ["photo1.jpg", "photo2.png", "design.webp"]
}这将打开一个可视化编辑器,您可以在其中:
- 画 在每张图像上用手绘标记(红色、黄色、绿色、蓝色、白色)
- 导航 在带有“后退”/“下一步”按钮的图像之间
- 添加注释 每张图片下(预填
Notes about {filename}:) - 合并 完成后,将所有提示合并为一个组合提示
工具返回:
annotatedImagePaths:带注释图像的路径(保存在.nano-banana-temp/文件夹)combinedPrompt:所有单独的提示连接在一起originalImagePaths:原始输入路径
当你想指出图像中需要编辑的特定区域时,这尤其有用,人工智能可以使用这些区域 edit_or_create_image.
注释快捷方式流程
如果用户已经在浏览器中完成了注释步骤,您可以调用 complete_annotation_edit 检索保存的注释结果,并在一次工具调用中立即应用编辑。
健康检查
使用 health_check 验证本地配置,并可选择测试OpenRouter连接:
{
"testApi": true
}许可证
麻省理工学院
