Gemini图像生成服务器

一个基于Gemini API的MCP服务器,用于原生图像生成,支持批量处理和队列管理。

  • by keeponfirst
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 keeponfirst/kof-nanobanana-mcp

使用说明

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密钥

  1. 首选 谷歌AI工作室
  2. 创建API密钥
  3. 重要:确保您的项目已启用计费。这些型号只收费。

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美元

许可证

麻省理工学院