KOF纳米香蕉MCP服务器🍌
用于Gemini本地映像生成的MCP服务器(Nano Banana)。部分 KeepOnFirst代理工作流.
英语| 繁体中文
⚠️ 重要提示:需要账单
注:Gemini API免费层不支持图像生成模型。 若要使用此MCP服务器,您必须从启用了计费的Google Cloud项目中提供API密钥。
特性
- 生成图像 使用Gemini 2.5 Flash图像或Gemini 3 Pro图像
- 进程队列 具有验证和模拟运行支持的提示文件
- YAML前体 支持快速配置
- 跨IDE兼容 -适用于任何启用MCP的客户端
☕ 支持这个项目
如果这个项目对你有帮助,你可以在这里支持开发:
安装
选项1:通过npx使用(推荐)
如果您已发布此包或在本地使用它:
{
"mcpServers": {
"nanobanana": {
"command": "npx",
"args": ["-y", "@keeponfirst/kof-nanobanana-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key-here"
}
}
}
}方案2:地方发展
cd kof-nanobanana-mcp
npm install
npm run build然后在MCP配置中配置绝对路径(请参阅配置部分)。
配置
1.获取Gemini API密钥
- 首选 谷歌AI工作室
- 创建API密钥
- 重要:确保您的项目已启用计费。这些型号只收费。
2.添加到MCP配置
添加到您的MCP配置文件中(例如。, ~/.gemini/antigravity/mcp_config.json):
{
"servers": {
"nanobanana": {
"command": "node",
"args": ["/path/to/kof-nanobanana-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "your-api-key-here"
}
}
}
}工具
nanobanana_generate_image
生成单个图像。
参数:
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
prompt | string | ✅ | 图像描述(10-5000个字符) |
output_path | string | ✅ | 保存图像的路径 |
model | string | ❌ | gemini-2.5-flash-image (默认)或 gemini-3-pro-image-preview |
aspect_ratio | string | ❌ | 1:1, 16:9, 9:16, 4:3, 3:4 |
overwrite | boolean | ❌ | 覆盖现有文件(默认值:false) |
例子:
{
"prompt": "A modern flat illustration of three AI robots working together on code",
"output_path": "assets/generated/workflow-hero.png",
"model": "gemini-2.5-flash-image",
"aspect_ratio": "16:9"
}nanobanana_list_queue
列出并验证队列中的提示文件。
参数:
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
queue_dir | string | ❌ | 队列目录(默认: nanobanana/queue) |
validate | boolean | ❌ | 验证文件(默认值:true) |
check_conflicts | boolean | ❌ | 检查输出是否存在(默认值:true) |
nanobanana_process_queue
批量处理所有提示文件。
参数:
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
queue_dir | string | ❌ | 队列目录(默认: nanobanana/queue) |
validate_only | boolean | ❌ | 仅验证,不生成 |
dry_run | boolean | ❌ | 在没有API调用的情况下预览 |
overwrite | string | ❌ | skip, overwrite,或 rename |
提示文件格式
创建 .md 文件位于 nanobanana/queue/ 使用YAML frontmatter:
---
output_path: assets/generated/workflow-hero.png
model: gemini-2.5-flash-image
aspect_ratio: 16:9
overwrite: false
---
# Workflow Hero Image
Create a modern, sleek hero illustration showing three AI agents
working together in a software development workflow.
## Style Guidelines
- Style: Flat illustration with gradients
- Color palette: Deep purple (#6B46C1) to blue (#3B82F6)
- Background: Subtle gradient定价参考
| 型号 | 每张图片的价格 |
|---|---|
| 双子座2.5闪光图像 | ~0.039美元(1024x1024) |
| 双子座3专业版图像(2K) | ~0.134美元 |
| Gemini 3 Pro图像(4K) | ~0.24美元 |
许可证
麻省理工学院
