MCP图像生成器
使用Gemini API的图像生成MCP服务器。从Claude Code调用以生成概念视觉描述。
设置
1.设置Gemini API密钥
https://aistudio.google.com/apikey获得API密钥.env 创建文件：
cp .env.example .env
# .env を編集して GEMINI_API_KEY にAPIキーを設定2.构建Docker映像
cd /path/to/mcp-image-generator
docker build -t mcp-image-generator .3.Claude Code注册MCP服务器
claude mcp add --transport stdio image-generator -- \
docker run -i --rm \
--env-file /path/to/mcp-image-generator/.env \
-v /path/to/mcp-image-generator/generated:/output \
mcp-image-generator/path/to/mcp-image-generator 将替换为此存储库的绝对路径。
如果你想在所有项目中使用它 --scope user 添加：
claude mcp add --scope user --transport stdio image-generator -- \
docker run -i --rm \
--env-file /path/to/mcp-image-generator/.env \
-v /path/to/mcp-image-generator/generated:/output \
mcp-image-generator| Scope | 効果 |
|---|
无（默认）=仅在当前项目中可用 | --scope user 在所有项目中都可用 | --scope project | .mcp.json 保存（面向团队共享）
现在从Claude Code开始 generate_image 工具可以使用了。
用法
在Claude Code内委托图像生成时generate_image 调用工具。
- 图像显示
generated/存储在目录中 - Claude Code
generated/复制到所需位置
参数
| 参数 | 必填 | 默认 | 说明 |
|---|---|---|---|
prompt ｜是｜-｜图像生成提示｜ | |||
filename | 没有 | generated.png 输出文件名 | |
aspect_ratio | 没有 | 16:9 | 1:1, 3:2, 4:3, 16:9, 9:16 |
model | 没有 | nano-banana-2 | nano-banana-2 (高速), nano-banana-pro （高品质） |
image_size | 没有 | 2K | 1K, 2K, 4K |
故障排除
- “未设置GEMINI_API_KEY环境变量”:
.env确认文件是否设置了密钥 - 权限不足:
generated/确认目录是否具有写入权限 - 找不到Docker映像:
docker build -t mcp-image-generator .执行 - 速率限制错误：Gemini Free tier为2images/min，500/day。稍等片刻
- 安全过滤器拒收：修改提示并重试
- 企业代理环境:
docker run的-e HTTP_PROXY -e HTTPS_PROXY添加