Package Exports

comet-nanobanana-zijie
comet-nanobanana-zijie/src/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (comet-nanobanana-zijie) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Comet Nano Banana MCP

基于 Comet API 的 Nano Banana (Gemini 3 Pro Image) 图片生成和编辑 MCP 服务器。

功能特性

文生图 (text_to_image): 根据文本描述生成高质量图片
图片编辑 (edit_image): 基于输入图片和文本提示进行智能编辑
多种宽高比支持: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
灵活的图片输入: 支持 URL、Base64 Data URI、本地文件路径
支持格式: png, jpg, jpeg, gif, webp

安装

使用 npx（推荐）

npx comet-nanobanana-zijie

全局安装

npm install -g comet-nanobanana-zijie

在 Claude Desktop 中使用

在 Claude Desktop 配置文件中添加 MCP 服务器配置：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "comet-nanobanana-zijie": {
      "command": "npx",
      "args": ["comet-nanobanana-zijie"],
      "env": {
        "COMET_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

重要: 请将 sk-your-api-key-here 替换为你的 Comet API 密钥。

本地开发配置

{
  "mcpServers": {
    "comet-nanobanana-zijie": {
      "command": "node",
      "args": ["/path/to/comet-nanobanana-zijie/src/index.js"],
      "env": {
        "COMET_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

工具说明

1. text_to_image - 文生图

根据文本描述生成图片。

参数:

prompt (必填, string): 图片描述文本
- 建议包含风格关键词（如 photorealistic, cyberpunk, watercolor）
- 描述主体、背景、光照、细节等
aspectRatio (可选, string): 图片宽高比
- 可选值: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
- 不设置时为默认比例
- 所有分辨率消耗 1290 tokens

示例:

{
  "prompt": "A cute white rabbit sitting in a garden with flowers, highly detailed, photorealistic, soft lighting",
  "aspectRatio": "16:9"
}

{
  "success": true,
  "image": {
    "base64": "iVBORw0KGgo...",
    "mimeType": "image/png",
    "size": 123456
  },
  "metadata": {
    "prompt": "...",
    "aspectRatio": "16:9",
    "model": "gemini-3-pro-image"
  }
}

2. edit_image - 图片编辑

基于输入图片和文本提示生成编辑后的图片。

参数:

prompt (必填, string): 编辑指令文本
- 描述如何修改图片，如风格转换、颜色调整、对象替换等
inputImage (必填, string): 输入图片，支持三种格式：
- HTTP(S) URL: https://example.com/image.jpg
- Data URI: data:image/png;base64,iVBORw0KGgo...
- 本地文件路径: /path/to/image.png 或 C:\path\to\image.jpg
- 支持格式: png, jpg, jpeg, gif, webp
aspectRatio (可选, string): 输出图片宽高比
- 可选值同上
- 不设置时自动适配输入图片比例

示例 1 - 黑白转换:

{
  "prompt": "Convert this image to black and white, maintain all details",
  "inputImage": "https://example.com/image.jpg"
}

示例 2 - 风格转换:

{
  "prompt": "Convert to watercolor painting style",
  "inputImage": "/Users/username/pictures/photo.png",
  "aspectRatio": "1:1"
}

示例 3 - 使用 Base64:

{
  "prompt": "Make the background blue sky",
  "inputImage": "data:image/png;base64,iVBORw0KGgo..."
}

{
  "success": true,
  "image": {
    "base64": "iVBORw0KGgo...",
    "mimeType": "image/png",
    "size": 234567
  },
  "metadata": {
    "prompt": "...",
    "aspectRatio": "auto",
    "inputImageType": "image/jpeg",
    "model": "gemini-3-pro-image"
  }
}

API 技术细节

Base URL: https://api.cometapi.com
Model: gemini-3-pro-image
Authorization: 直接使用 API Key（不需要 Bearer 前缀）
Token 消耗: 所有分辨率消耗 1290 tokens

参考文档

常见问题

Q: 支持哪些图片格式？ A: 输入支持 png, jpg, jpeg, gif, webp；输出通常为 png。

Q: 图片编辑时 Base64 需要带前缀吗？ A: Data URI 格式需要完整前缀（data:image/png;base64,...），但如果你直接传纯 Base64，代码会自动处理。

Q: 默认宽高比是多少？ A: 官方文档未明确说明，建议不设置时让 API 自动决定，或手动指定如 1:1。

Q: 如何获取 API Key？ A: 访问 Comet API 官网注册并获取密钥。

许可证

MIT

作者

zijie