OpenAI 图像生成 MCP

这是一个用于 OpenAI 图像生成 API 的模型上下文协议 (MCP) 服务器。此 MCP 允许像 Claude 这样的 AI 助手使用 OpenAI 的 GPT-image-1 模型来生成和编辑图像。

目录

• 特性
• 安装
• 快速开始
• 配置
• 详细文档
• 许可证

特性

• 使用 OpenAI 的图像生成模型生成图像
• 使用文本提示和可选掩码编辑现有图像
• 自动将生成的图像保存到本地存储
• 可选地将生成的图像上传到 Cloudflare ImgBed
• 健康检查端点以验证服务器状态
• 多种方式提供 API 密钥（环境变量、命令行、直接）

安装

1. 克隆仓库并安装依赖项：

git clone https://github.com/yourusername/openai-image-gen-mcp.git
cd openai-image-gen-mcp
npm install

2. 构建 TypeScript 项目：

npm run build

快速开始

1. 使用运行脚本（推荐用于生产）

启动全功能 MCP 服务器最简单的方法：

./run-with-key.sh

该脚本嵌入了 API 密钥，并启动了具有所有功能的 MCP 服务器。

2. 使用直接 API 密钥（用于测试）

node hardcoded-key.js

这是一个简化版本，API 密钥直接嵌入在代码中。

3. 使用环境变量

export OPENAI_API_KEY=your-api-key
./start.sh

配置

Claude MCP 配置

要将 Claude 连接到此 MCP，请使用以下配置文件：

{
  "mcpServers": {
    "openai-image-gen": {
      "command": "node",
      "args": ["/Users/jerry/openai-image-gen-mcp/build/index.js"]
    }
  }
}

⚠️ 重要：对于生产环境，请使用全功能编译版本 (build/index.js)。简化版本仅用于测试和教育。

可用工具

MCP 向 Claude 提供了这些工具：

1. oai_generate_image - 从文本提示生成图像
2. oai_edit_image - 使用文本提示编辑现有图像
3. health_check - 验证服务器健康状态

在 Claude 中的示例用法：

生成一幅日落山景图，前景有一片湖泊。

Claude 将使用适当的 MCP 工具来创建图像。

详细文档

更多详细信息，请参阅：

• 架构 - 系统设计和组件
• 流水线 - 开发和请求处理流水线
• 指南 - 最佳实践和使用指南
• 解释 - 代码和 API 的详细解释

目录结构

openai-image-gen-mcp/
├── build/              # 编译后的 JavaScript 代码
├── docs/               # 文档文件
├── output/             # 生成的图像
├── src/                # TypeScript 源代码
│   ├── config.js       # 配置管理
│   └── index.ts        # 主 MCP 服务器实现
├── *.sh                # 辅助脚本
├── *.js                # 简化版本和实用工具
└── *.json              # 配置文件

故障排除

如果遇到问题：

1. 检查您的 API 密钥是否有效且格式正确
2. 确保输出目录存在且可写
3. 运行健康检查以验证服务器状态
4. 查看日志获取详细的错误信息
5. 尝试简化版本以隔离问题

更多帮助，请参阅指南中的故障排除部分。