Openai Image Gen MCP

OpenAI图像生成MCP

用于OpenAI图像生成API的模型上下文协议（MCP）服务器。该MCP使Claude等AI助手能够使用OpenAI的GPT-image-1模型生成和编辑图像。

目录

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

特性

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

安装

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

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

1. 构建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. 健康检查 -验证服务器的运行状况

Claude中的示例用法：

Generate an image of a sunset over mountains with a lake in the foreground.

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

详细文件

有关更多详细信息，请参阅：

• 建筑 -系统设计和组件
• 管道 -开发和请求处理管道
• 指南 -最佳实践和使用指南
• 解释 -代码和API的详细说明

目录结构

openai-image-gen-mcp/
├── build/              # Compiled JavaScript code
├── docs/               # Documentation files
├── output/             # Generated images
├── src/                # TypeScript source code
│   ├── config.js       # Configuration management
│   └── index.ts        # Main MCP server implementation
├── *.sh                # Helper scripts
├── *.js                # Simplified versions and utilities
└── *.json              # Configuration files

故障排除

如果您遇到问题：

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

有关更多帮助，请参阅 故障排除部分 在指导方针中。