openai-gpt-图像-mcp

OpenAI 的 GPT-4o/gpt-image-1 图像生成和编辑 API 的模型上下文协议 (MCP) 工具服务器。

• 使用 OpenAI 的最新模型根据文本提示生成图像。

• 使用高级提示控制编辑图像（修复、去除修复、合成）。

• 支持：Claude Desktop、Cursor、VSCode、Windsurf 以及任何与 MCP 兼容的客户端。

✨ 特点

• create-image ：根据提示生成图像，并带有高级选项（大小、质量、背景等）。

• edit-image ：使用提示和可选掩码编辑或扩展图像，支持文件路径和 base64 输入。

• 文件输出：将生成的图像直接保存到磁盘，或以 base64 形式接收。

Related MCP server: imagegen-mcp

🚀 安装

git clone https://github.com/SureScaleAI/openai-gpt-image-mcp.git
cd openai-gpt-image-mcp
yarn install
yarn build

🔑 配置

添加到 Claude Desktop 或 VSCode（包括 Cursor/Windsurf）配置：

{
  "mcpServers": {
    "openai-gpt-image-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": { "OPENAI_API_KEY": "sk-..." }
    }
  }
}

⚡ 高级

• 对于create-image ，设置n以一次生成最多 10 张图像。

• 对于edit-image ，提供一个遮罩图像（文件路径或 base64）来控制编辑的应用位置。

• 请参阅src/index.ts了解所有选项。

🧑‍💻开发

• TypeScript 源代码： src/index.ts

• 构建： yarn build

• 运行： node dist/index.js

📝 许可证

麻省理工学院

🩺 故障排除

• 确保您的OPENAI_API_KEY有效并且具有图像 API 访问权限。

• 您必须拥有一个经过验证的 OpenAI 组织。验证后，可能需要 15-20 分钟才能激活图像 API 访问权限。

• 文件路径必须是绝对路径。

• 对于文件输出，请确保目录是可写的。

• 如果您发现有关文件类型的错误，请检查图像文件扩展名和格式。

⚠️ 限制和大文件处理

• 1MB 有效负载限制： MCP 客户端（包括 Claude Desktop）对工具响应的大小有 1MB 的硬性限制。大图像（尤其是高分辨率或多幅图像）如果以 base64 格式返回，很容易超出此限制。

• **自动切换到文件输出：**如果图片总大小超过 1MB，该工具将自动将图片保存到磁盘并返回文件路径（而非 base64 编码）。这确保了兼容性，并避免了诸如result exceeds maximum length of 1048576类的错误。

• **默认文件位置：**如果您未指定file_output路径，图像将以唯一的文件名保存到/tmp （或MCP_HF_WORK_DIR环境变量设置的目录）。

• 环境变量：

  • MCP_HF_WORK_DIR ：设置此项以控制大图像和文件输出的保存位置。例如： export MCP_HF_WORK_DIR=/your/desired/dir

• **最佳实践：**对于大型或生产图像，始终使用文件输出并确保您的客户端配置为处理文件路径。

📚 参考文献

• OpenAI 图像 API 文档

🙏 致谢

• 使用@modelcontextprotocol/sdk构建

• 使用openai Node.js SDK

• 由SureScale.ai构建