A
licenseNot graded
qualityF
maintenanceA server that provides AI-powered image generation, modification, and processing capabilities through the Model Context Protocol, leveraging Google Gemini models and other image services.
18
MIT
GPT Image 1 MCP
🚀 快速入门
npx -y @cloudwerxlab/gpt-image-1-mcp📋 先决条件
🔑 环境变量
💻 NPX 用法示例
# Set your OpenAI API key
export OPENAI_API_KEY=sk-your-openai-api-key
# Optional: Set custom output directory
export GPT_IMAGE_OUTPUT_DIR=/home/username/Pictures/ai-generated-images
# Run the server with NPX
npx -y @cloudwerxlab/gpt-image-1-mcp# Set your OpenAI API key
$env:OPENAI_API_KEY = "sk-your-openai-api-key"
# Optional: Set custom output directory
$env:GPT_IMAGE_OUTPUT_DIR = "C:\Users\username\Pictures\ai-generated-images"
# Run the server with NPX
npx -y @cloudwerxlab/gpt-image-1-mcp:: Set your OpenAI API key
set OPENAI_API_KEY=sk-your-openai-api-key
:: Optional: Set custom output directory
set GPT_IMAGE_OUTPUT_DIR=C:\Users\username\Pictures\ai-generated-images
:: Run the server with NPX
npx -y @cloudwerxlab/gpt-image-1-mcpRelated MCP server: OpenAI MCP
🔌 与 MCP 客户端集成
🛠️ 在 MCP 客户端中设置
{
"mcpServers": {
"gpt-image-1": {
"command": "npx",
"args": [
"-y",
"@cloudwerxlab/gpt-image-1-mcp"
],
"env": {
"OPENAI_API_KEY": "PASTE YOUR OPEN-AI KEY HERE",
"GPT_IMAGE_OUTPUT_DIR": "OPTIONAL: PATH TO SAVE GENERATED IMAGES"
}
}
}
}不同操作系统的示例配置
{
"mcpServers": {
"gpt-image-1": {
"command": "npx",
"args": ["-y", "@cloudwerxlab/gpt-image-1-mcp"],
"env": {
"OPENAI_API_KEY": "sk-your-openai-api-key",
"GPT_IMAGE_OUTPUT_DIR": "C:\\Users\\username\\Pictures\\ai-generated-images"
}
}
}
}{
"mcpServers": {
"gpt-image-1": {
"command": "npx",
"args": ["-y", "@cloudwerxlab/gpt-image-1-mcp"],
"env": {
"OPENAI_API_KEY": "sk-your-openai-api-key",
"GPT_IMAGE_OUTPUT_DIR": "/home/username/Pictures/ai-generated-images"
}
}
}
}注意：对于 Windows 路径，请使用双反斜杠 (
\\) 来转义 JSON 中的反斜杠字符。对于 Linux/macOS，请使用正斜杠 (/)。
✨ 特点
💡 增强功能
🔄 工作原理
📁 输出目录行为
安装和使用
NPM 包
此软件包可在 npm 上获取： @cloudwerxlab/gpt-image-1-mcp
您可以全局安装它：
npm install -g @cloudwerxlab/gpt-image-1-mcp或者直接使用 npx 运行它，如快速入门部分所示。
工具： create_image
根据文本提示生成新图像。
参数
范围 | 类型 | 必需的 | 描述 |
| 细绳 | 是的 | 要生成的图像的文本描述（最多 32,000 个字符） |
| 细绳 | 不 | 图像尺寸：“1024x1024”（默认）、“1536x1024”或“1024x1536” |
| 细绳 | 不 | 图像质量：“高”（默认）、“中”或“低” |
| 整数 | 不 | 生成的图像数量（1-10，默认值：1） |
| 细绳 | 不 | 背景样式：“透明”、“不透明”或“自动”（默认） |
| 细绳 | 不 | 输出格式：“png”（默认）、“jpeg”或“webp” |
| 整数 | 不 | 压缩级别（0-100，默认值：0） |
| 细绳 | 不 | OpenAI 使用情况跟踪的用户标识符 |
| 细绳 | 不 | 审核级别：“低”或“自动”（默认） |
例子
<use_mcp_tool>
<server_name>gpt-image-1</server_name>
<tool_name>create_image</tool_name>
<arguments>
{
"prompt": "A futuristic city skyline at sunset, digital art",
"size": "1024x1024",
"quality": "high",
"n": 1,
"background": "auto"
}
</arguments>
</use_mcp_tool>回复
该工具返回：
包含所生成图像详细信息的格式化文本消息
以 base64 编码的数据格式显示图像
元数据包括令牌使用情况和文件路径
工具： create_image_edit
根据文本提示和可选掩码编辑现有图像。
参数
范围 | 类型 | 必需的 | 描述 |
| 字符串、对象或数组 | 是的 | 要编辑的图像（base64字符串或文件路径对象） |
| 细绳 | 是的 | 所需编辑的文本描述（最多 32,000 个字符） |
| 字符串或对象 | 不 | 定义要编辑的区域的掩码（base64字符串或文件路径对象） |
| 细绳 | 不 | 图像尺寸：“1024x1024”（默认）、“1536x1024”或“1024x1536” |
| 细绳 | 不 | 图像质量：“高”（默认）、“中”或“低” |
| 整数 | 不 | 生成的图像数量（1-10，默认值：1） |
| 细绳 | 不 | 背景样式：“透明”、“不透明”或“自动”（默认） |
| 细绳 | 不 | OpenAI 使用情况跟踪的用户标识符 |
Base64 编码图像示例
<use_mcp_tool>
<server_name>gpt-image-1</server_name>
<tool_name>create_image_edit</tool_name>
<arguments>
{
"image": "BASE64_ENCODED_IMAGE_STRING",
"prompt": "Add a small robot in the corner",
"mask": "BASE64_ENCODED_MASK_STRING",
"quality": "high"
}
</arguments>
</use_mcp_tool>文件路径示例
<use_mcp_tool>
<server_name>gpt-image-1</server_name>
<tool_name>create_image_edit</tool_name>
<arguments>
{
"image": {
"filePath": "C:/path/to/your/image.png"
},
"prompt": "Add a small robot in the corner",
"mask": {
"filePath": "C:/path/to/your/mask.png"
},
"quality": "high"
}
</arguments>
</use_mcp_tool>回复
该工具返回：
包含已编辑图像详细信息的格式化文本消息
编辑后的图像作为 base64 编码数据
元数据包括令牌使用情况和文件路径
🔧 故障排除
🚨常见问题
🔍 错误处理和报告
MCP 服务器包含全面的错误处理功能，可在出现问题时提供详细信息。发生错误时：
错误格式：所有错误均返回：
清晰的错误信息，描述出了什么问题
具体的错误代码或类型
如果有关于错误的附加上下文
AI 助手行为：当此 MCP 服务器与 AI 助手一起使用时：
人工智能将始终报告完整的错误消息以帮助排除故障
人工智能将用通俗易懂的语言解释错误的可能原因
人工智能将建议解决问题的具体步骤
📄 许可证
🙏 致谢
Maintenance
–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server enabling AI assistants to generate images through OpenAI's DALL-E API with full support for all available options and fine-grained control.261MIT
- AlicenseDqualityDmaintenanceA Model Context Protocol server that provides image generation capabilities using Google's Gemini 2 API, allowing users to generate multiple images with customizable parameters like prompts, aspect ratios, and person generation settings.11895MIT
- AlicenseBqualityCmaintenanceA Model Context Protocol server that provides OpenAI's DALL-E 3 image generation capabilities, allowing LLMs to generate high-quality images through a standardized interface.1351MIT
Related MCP Connectors
MCP server for NanoBanana AI image generation and editing
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/CLOUDWERX-DEV/gpt-image-1-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server