openai图像mcp服务器
用于OpenAI图像生成的MCP服务器。使用gpt图像模型族生成、编辑和创建图像变体(gpt-image-1, gpt-image-1-mini, gpt-image-1.5, gpt-image-2)--直接从任何兼容MCP的客户端，如Claude Desktop、Cursor或VS Code。
DALL-E 2 / DALL-E 3 已删除。 OpenAI于2026年5月12日退役了两款DALL-E模型。此服务器现在仅针对gpt映像系列。这gpt_image_create_variation该工具在编辑端点之上重新实现，因为/v1/images/variations终点随着DALL-E 2的消失而消失。
工具
| 工具 | 说明 |
|---|---|
gpt_image_generate | 从文本提示生成图像 |
gpt_image_edit | 使用修复/遮罩编辑现有图像 |
gpt_image_create_variation | 创建图像的风格变体（通过编辑端点） |
gpt_image_create_character_reference | 为游戏角色生成基础参考图像 |
gpt_image_generate_pose | 从角色参考图像生成任何姿势/动作 |
gpt_image_generate_sprite_sheet | 生成多帧子画面（便利包装） |
需求
- Node.js 18+
- 一 OpenAI API密钥
安装
克劳德桌面版
添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：
{
"mcpServers": {
"gpt-image-gen": {
"command": "npx",
"args": ["-y", "openai-image-mcp-server@latest"],
"env": {
"OPENAI_API_KEY": "sk-..."
}
}
}
}光标
添加到光标MCP设置(~/.cursor/mcp.json):
{
"mcpServers": {
"gpt-image-gen": {
"command": "npx",
"args": ["-y", "openai-image-mcp-server@latest"],
"env": {
"OPENAI_API_KEY": "sk-..."
}
}
}
}VS代码（带副驾驶MCP扩展）
添加到您的VS代码 settings.json:
{
"mcp.servers": {
"gpt-image-gen": {
"command": "npx",
"args": ["-y", "openai-image-mcp-server@latest"],
"env": {
"OPENAI_API_KEY": "sk-..."
}
}
}
}克劳德代码
添加 ~/.claude/settings.json:
{
"env": {
"OPENAI_API_KEY": "sk-..."
},
"mcpServers": {
"openai-image": {
"command": "npx",
"args": ["-y", "openai-image-mcp-server"]
}
}
}或者通过CLI：
claude mcp add openai-image -e OPENAI_API_KEY=sk-... -- npx -y openai-image-mcp-server@latest手册（来源）
git clone https://github.com/YOUR_USERNAME/openai-image-mcp-server
cd openai-image-mcp-server
npm install
npm run build
OPENAI_API_KEY=sk-... node dist/index.js工具参考
gpt_image_generate
从文本提示生成一个或多个图像。
| 参数 | 类型 | 默认值 | 说明 | |||
|---|---|---|---|---|---|---|
prompt | string | 必填 | 图像的文本描述 | |||
model | gpt-image-1 | gpt-image-1-mini | gpt-image-1.5 | gpt-image-2 | gpt-image-2 | 要使用的模型 |
n | 数字（1-10） | 1 | 图像数量 | |||
size | 1024x1024 | 1024x1536 | 1536x1024 | auto | 1024x1024 | 输出尺寸 |
quality | low | medium | high | auto | -- | 质量等级 |
background | transparent | opaque | auto | -- | 透明需要png/webp。gpt-image 2不支持 | |
output_format | png | jpeg | webp | png | 输出文件格式 | |
output_compression | 数字（0-100） | -- | jpeg/webp压缩 | |||
output_directory | 字符串 | ./openai-image-gen | 保存文件的目录 |
图像总是以base64数据的形式返回并写入磁盘。gpt图像模型不生成URL。
示例：
Generate a photorealistic portrait of a tabby cat sitting on a windowsillGenerate a wide cinematic shot of a foggy mountain valley at sunrise
→ model: gpt-image-2, size: 1536x1024, quality: highGenerate a glowing magic crystal with transparent background
→ background: transparent, output_format: png______________________________________________________________________
gpt_image_edit
使用文本提示编辑现有图像。支持使用可选遮罩进行修复——遮罩中的透明像素定义了要编辑的区域。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
image_path | string | 必填 | 源PNG的绝对路径（\ 提示： 越具体你 character_description，3帧越一致。包括艺术风格（如“像素艺术”、“赤壁”、“平面卡通”）、颜色细节和任何独特的配饰。 |
______________________________________________________________________
模型比较
| gpt-image 1 | gpt-image 1-mini | gpt-image1.5 | gpt-mage2 | |
|---|---|---|---|---|
| 生成 | ✓ | ✓ | ✓ | ✓ |
| 编辑 | ✓ | ✓ | ✓ | ✓ |
| 变化（通过编辑） | ✓ | ✓ | ✓ | ✓ |
| 透明背景 | ✓ | ✓ | ✓ | ✗ |
| 尺寸 | 1024²/1024×1536/1536×1024 | 相同 | 相同 | 灵活（≤3840px，16px倍数） |
| 输出格式 | png/jpeg/webp | same | same | 相同 |
| 最适合 | 传统 | 经济高效的批量 | 快速+透明bg | 默认 ·最先进的质量，文本渲染 |
将图像保存到磁盘
所有gpt图像模型都返回base64数据（无URL）。生成的图像会自动写入磁盘--pass output_directory 自定义位置，否则文件将进入 ./openai-image-gen.
Generate a sunset landscape and save it
→ output_directory: /Users/me/Desktop文件另存为 generated__., edited__.，或 variation__. 哪里 ` 火柴 output_format （默认值 png`).
许可证
麻省理工学院