AI导哈

图像生成服务器

使用Gemini API的MCP服务器，通过Claude Code调用生成概念性视觉描述图像。

  • by Kuroakira
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Kuroakira/mcp-image-generator

使用说明

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 调用工具。

  1. 图像显示 generated/ 存储在目录中
  2. Claude Code generated/<filename> 复制到所需位置

参数

参数 必填 默认 说明
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 添加

相关 MCP