使用说明
Gemini映像MCP服务器
给AI提供图像生成的眼睛。
端点:
https://gemini-image-mcp-two.vercel.app/api/mcp
Claude、Cursor、Windsurf、VS Code、其他所有MCP客户端只需说“生成图像”,Gemini/Mimagen的图像生成AI就会移动。
3个MCP工具(generate_image/edit_image/list_models)覆盖了从文本生成图像和编辑现有图像。对应6个模型,从博客插图到产品快照,SNS素材广泛对应。
能做的事
「桜並木を歩く猫のイラストを描いて」
→ Nano Banana 2 で画像生成 → base64画像が返る
「この画像の背景を夕焼けの海に変えて」
→ 画像 + 指示テキストで編集 → 編集後の画像が返る
「ブログ用のヘッダー画像を横長で作って。テーマは"AI×美容"」
→ 16:9アスペクト比で画像生成
「商品写真の背景を白に変更して、ECサイト用にして」
→ 画像編集で背景除去・変更
「この人の写真にこのヘアスタイルを合成して」
→ 顔写真 + ヘアスタイル参照画像 → 複数画像合成
「人物写真をこの背景に自然に合成して、スタジオ撮影風にして」
→ 人物 + 背景 + テキスト指示 → 複数画像合成
支持的模型(6个模型)
Gemini Native(Nano Banana)— 会話型画像生成・編集
|模型|ID|价格|特征|
|:--|:--|:--|:--|
| 纳米香蕉2 | gemini-3.1-flash-image-preview | $0.045/枚 | 高速・4K対応。默认建议 |
| 纳米香蕉Pro | gemini-3-pro-image-preview |$0.134/张|最高品质・Thinking对应・文本精度94%|
| 纳米香蕉 | gemini-2.5-flash-image | $0.039/枚 | 最安Native・安定 |
图像4-文本-图像专用
|模型|ID|价格|特征|
|:--|:--|:--|:--|
| 图4快速 | imagen-4.0-fast-generate-001 | $0.02/枚 | 最安・面向量产
| 图4 | imagen-4.0-generate-001 | $0.04/枚|高品质|
| 图像4 Ultra | imagen-4.0-ultra-generate-001 | $0.06/枚| 2K最高质量|
工具列表(3工具)
工具列表(4工具)
工具|说明|
|:--|:--|
| generate_image 从文本提示生成图像。全6个模型对应。Imagen可以指定宽高比、多张
| edit_image 用现有图像+文本指示编辑图像。仅Gemini Native模型
| compose_images 将多个图像(2~14张)进行合成、混合、风格转印。脸+发型合成、背景合成、样式转印等
| list_models 查看可用模型的列表、价格和建议用途
🔒 安全性
- 所有的通讯 HTTPS(TLS暗号化) 保护
- 服务器是无状态。API密钥仅在请求处理期间使用不保存也不输出日志
- 无数据库。只作为Gemini API的代理运行
- 源代码全公开
不安的情况: 部署到自己的Vercel api_key 的规格化距离的幂函数。
快速启动(2步)
步骤1:获取Gemini API密钥
Google AI 工作室 -创建并复制API密钥
有免费名额(约500个要求/天)。收费是Pay-as-you-go,$0.02~/张。
步骤2:连接MCP服务器
克劳德·艾(网络): 设置→ MCP → Add:
- 网址:
https://gemini-image-mcp-two.vercel.app/api/mcp - Header名:
Authorization値:Bearer あなたのGemini API Key
克劳德桌面/光标/VS代码/风帆:
{
"mcpServers": {
"gemini-image": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://gemini-image-mcp-two.vercel.app/api/mcp"],
"env": {
"HEADER_Authorization": "Bearer あなたのGemini API Key"
}
}
}
}
克劳德代码:
claude mcp add --transport http gemini-image https://gemini-image-mcp-two.vercel.app/api/mcp \
--header "Authorization: Bearer あなたのGemini API Key"
验证模式
模式|用途|设置|
|:--|:--|:--|
| gemini_key(默认)|个人使用·验证|不需要设置。在授权题头中发送API密钥
| api_key |团队运营、正式生产| AUTH_MODE=api_key, MCP_API_KEY=xxx, GEMINI_API_KEY=xxx |
自己部署
git clone https://github.com/DaisukeHori/gemini-image-mcp.git
cd gemini-image-mcp
cp .env.example .env.local
# .env.local を編集
npm install
npm run dev
常见问题解答
Q:可以免费使用吗? →谷歌AI Studio的免费框架(约500请求/日)范围内免费。超过的部分是Pay-as-you-go收费。
Q:可以使用日语提示吗? →是的。但是英语有精度高的倾向。如果用日语发出指示,建议AI翻译成英语后生成。
Q:生成图像的尺寸是? →Nano Banana2最大为4K,Imagen4Ultra为2K。默认值为1K(1024×1024)。
Q:画像编辑哪个模型对应? →仅Gemini Native模型(Nano Banana系)。Imagen4仅用于生成,不可编辑。
Q:Claude的会话中显示图像? →通过MCP协议的image content type返还,因此对应客户端将直接显示图像。
容器辅助对象
在Claude.ai容器环境等中想要将图像保存到文件系统时utils/gemini_helper.py 中所述修改相应参数的值。
# ダウンロード
curl -sL https://raw.githubusercontent.com/DaisukeHori/gemini-image-mcp/main/utils/gemini_helper.py -o gemini_helper.py
from gemini_helper import generate_image, edit_image, compose_images, generate_batch
# 画像生成→ファイル保存
generate_image("A sunset over Mount Fuji", save_to="fuji.jpg")
# 画像編集
edit_image("fuji.jpg", "水墨画スタイルに変換", save_to="fuji_ink.jpg")
# 複数画像合成(顔+ヘアスタイル等)
compose_images(
images=[
{"path": "face.jpg", "role": "顔写真"},
{"path": "hair.jpg", "role": "ヘアスタイル"},
],
instruction="顔写真にヘアスタイルを適用して",
save_to="result.jpg"
)
# バッチ生成(PPTX挿絵50枚等)
generate_batch([
{"prompt": "スライド1の挿絵", "filename": "slide01.jpg"},
{"prompt": "スライド2の挿絵", "filename": "slide02.jpg"},
], output_dir="images")
使用MCP服务器(Vercel)作为HTTP代理generativelanguage.googleapis.com 而需要与环境混合的每条反射光线,进行环境采样。
技术栈
Next.js 15/TypeScript/Vercel/MCP SDK/Gemini API/Zod
许可证
MIT许可证
相关MCP服务器
堀公开的MCP服务器群。全部可从Claude.ai/Cursor/ChatGPT等MCP客户端使用。
|服务器|工具数|说明| |:--|:--:|:--| | b2cloud api 大和B2云发票发行API/MCP | 云闪mcp |69 | Cloudflare統合(隧道/DNS/工人/页面/R2/KV/SSL/访问)| | 马mcp |128 | HubSpot MA(客户关系管理/营销/知识库)| | msgraph mcp服务器 |48 | Microsoft Graph API(Exchange/Teams/OneDrive/SharePoint)| | 剧作家devtools mcp 浏览器自动化 | proxmox mcp服务器 | 35 | Proxmox VE反想化基盘操作| | 打印机mcp服务器 |—|CUPS网络打印机控制(Kyocera TASKalfa)| | yamato打印机mcp服务器 '-大和发票热敏打印机(胶皮+WS-420B) | ssh-mcp服务器 10个SSH客户端(会话管理/异步命令) | mac远程mcp [34][macOS远程控制(Shell/GUI/文件/应用程序)] | 双子座图像mcp ←现在这里|Gemini/Mimagen图像生成| | runpod mcp |36 | RunPod GPU FaaS(Pod/端点/作业)| | 耐火材料 _自动主机网络扫描 | 广告运营mcp | 62 |廣告运用自动化(Google Ads/Meta/GBP/X)|