使用说明
Nanobanana Image Studio
MCPB extension for Claude Desktop & Claude Cowork
Generate, edit, and analyze images using Google's Nano Banana 2 model
这是什么？
一个单击即可安装的扩展，使Claude能够生成和编辑图像。它涵盖了谷歌的 gemini-3.1-flash-image-preview 作为MCP工具，Claude可以自主创建视觉效果——产品镜头、营销资产、风格一致的品牌形象等等。
与 2甲4氯丁酸 （MCP捆绑包）格式。
安装
- 下载
nanobananaMCPB.mcpb从最新版本 - 打开克劳德桌面→ 设置→ 扩展→ 高级设置→ 安装扩展
- 选择已下载的
.mcpb归档并确认 - 配置 你的 Google AI Studio API密钥 并在提示时输出目录
无需安装Node.js——Claude Desktop捆绑了所有东西。
更新
下载最新 .mcpb 从 发布页面 并遵循相同的安装路径： 设置→ 扩展→ 高级设置→ 安装扩展.Claude Desktop更新了扩展程序，无需卸载。
工具
| 工具 | 说明 |
|---|---|
generate_image |
队列文本到图像生成--立即返回 job_id |
edit_image |
队列图像编辑--立即返回 job_id |
check_generation |
轮询排队作业的状态、已用时间和输出文件详细信息 |
extract_visual_dna |
将图像的美学逆向工程为结构化JSON |
describe_image |
生成任何图像的详细文本描述 |
list_templates |
浏览8个内置的Visual DNA样式模板 |
get_template |
检索模板的JSON以供使用 generate_image |
快速示例
生成图像
“为我们的耳机产品页面创建英雄形象”
生成异步运行-- generate_image 立即返回a job_id，然后克劳德民意调查 check_generation 直到文件准备就绪（通常为10-90秒，具体取决于分辨率和思维水平）。
1. generate_image({
"prompt": "Premium wireless headphones floating on a dark gradient, dramatic product lighting",
"aspect_ratio": "16:9",
"image_size": "2K",
"thinking_level": "high"
})
→ job_id: a1b2c3, output_path: ~/Desktop/nanobanana-output/2026-03-27-premium-headphones-a1b2c3.png
Estimated time: ~75s
2. check_generation({ "job_id": "a1b2c3" })
→ Status: complete | Actual: 61s | File: ...premium-headphones-a1b2c3.png (1.8 MB)
风格与视觉DNA的一致性
从参考图像中提取美学DNA，然后将其应用于新对象：
1. extract_visual_dna({ images: ["/path/to/brand-photo.jpg"] })
→ { "style": "...", "lighting": "...", "camera": "...", ... }
2. generate_image({
prompt: "A smart water bottle with LED display",
visual_dna: { ...extracted DNA... }
})
→ New image matching the original brand aesthetic
编辑现有图像
{
"images": ["/path/to/portrait.jpg"],
"prompt": "Replace the background with a golden sunset beach scene, keep the subject as-is",
"thinking_level": "high"
}
使用内置模板
1. list_templates()
→ cinematic_fujifilm, blueprint_3d, noir_dramatic, vintage_polaroid, ...
2. get_template({ name: "noir_dramatic" })
→ { "style": "Film noir, high contrast black and white, ..." }
3. generate_image({
prompt: "A detective under a streetlight in a rain-soaked alley",
visual_dna: { ...noir template... }
})
自主工作流程（Claude Cowork）
克劳德自动链工具。两者 generate_image 呼叫会立即排队，然后Claude会轮询这两个作业，直到完成，然后再起草电子邮件：
User: "Create a product launch email with custom images"
Claude:
1. generate_image → hero banner (16:9, 2K) → job_id: abc
2. generate_image → lifestyle product shot (4:3) → job_id: def
3. check_generation(abc) → complete (61s)
4. check_generation(def) → complete (38s)
5. describe_image → alt text for accessibility
6. gmail_create_draft → compose email with images attached
看 示例.md 查看更详细的示例。
视觉DNA模板
8个预构建样式模板可供使用：
| 模板 | 样式 |
|---|---|
cinematic_fujifilm |
电影般的电影，黄金时段，暖色调 |
blueprint_3d |
技术蓝图、正交投影 |
product_photography |
干净的电子商务就绪，白色背景 |
watercolor_illustration |
手绘触感，柔软洗涤 |
flat_vector |
现代简约的几何形状 |
noir_dramatic |
黑色电影，高对比度黑白 |
isometric_3d |
游戏艺术风格，等距立体模型 |
vintage_polaroid |
怀旧的即时胶片，褪色的色调 |
配置
在安装过程中通过Claude Desktop的设置UI进行设置：
| 设置 | 说明 | 默认值 |
|---|---|---|
| Gemini API密钥 | 您的Google AI Studio API密钥 | （必填） |
| 输出目录 | 生成的图像保存在哪里 | ~/Desktop/nanobanana-output |
| 双子座模型 | 型号ID（GA时更改） | gemini-3.1-flash-image-preview |
| 条形图像元数据 | 在发送到API之前，从JPEG中剥离EXIF/IPTC | true |
参数
纵横比
1:1 16:9 9:16 4:3 3:4 21:9 4:5 5:4 1:4 4:1 1:8 8:1 2:3 3:2
图片尺寸
0.5K （512像素）· 1K （1024px，默认值）· 2K （2048像素）· 4K （4096px）
思维层次
| 级别 | 用途 |
|---|---|
minimal |
生成速度快，构图简单 |
high （默认） |
复杂的场景、图像中的文本、精确的提示遵守 |
发展
git clone https://github.com/OhJayGee/nanobanana2-mcpb.git
cd nanobanana2-mcpb
npm install
npm test # Run 120 tests
npm run scan # Semgrep security scan (203 rules)
npm run build # Bundle with esbuild
npm run pack # Build + pack .mcpb
文档
| 文档 | 描述 |
|---|---|
| 建筑.md | 系统架构、数据流图、异步作业队列、安全模型、EMA启发式 |
| 测试.md | 测试结构（单元、e2e、集成、实时）、覆盖细节、安全测试矩阵 |
| 示例.md | 详细的使用示例和工作流模式 |
| 隐私.md | 隐私政策-哪些数据被发送到谷歌的Gemini API |
隐私
此扩展将提示和图像发送到Google的Gemini API进行处理。您的API密钥存储在本地操作系统密钥链中。看 隐私.md 了解全部细节。
许可证
麻省理工学院 — 版权所有 2026 OhJayGee
