MCP Openai Image

MCP OpenAI图像生成服务器

 ](https://badge.fury.io/js/@aiondadotcom%2Fmcp-openai-image)

模型上下文协议（MCP）服务器，与OpenAI的图像生成API集成，用于创建、编辑和流式传输图像。图像会自动保存到桌面，以便人工智能应用程序轻松访问。

备注：此徽标由MCP OpenAI Image Server本身生成，展示了服务器的图像生成功能。

特性

• 图像生成：使用OpenAI的GPT-Image-1模型创建图像
• 多回合编辑：使用对话历史记录编辑现有图像
• 流媒体支持：实时局部图像生成
• 桌面集成：自动保存到 ~/Desktop
• 内部配置：安全的API密钥管理
• STDIO传输：超出标准输入/输出

安装

npm install
npm run build

用法

发展

npm run dev

生产

npm run build
npm start

配置

服务器在内部管理自己的配置。首次使用时，配置您的OpenAI API密钥：

{
  "name": "configure-server",
  "arguments": {
    "apiKey": "sk-your-openai-api-key",
    "organization": "optional-org-id",
    "model": "gpt-4.1-mini"
  }
}

可用工具

1.生成图像

使用OpenAI的图像生成API生成图像。

参数：

• prompt （必填）：图像描述
• size：图像尺寸（1024x1024、1024x1536、1536x1024）
• quality：图像质量（标准，高清）
• format：输出格式（png、jpeg、webp）
• background：背景设置（透明、不透明、自动）
• compression：JPEG/WebP的压缩级别（0-100）

2.配置服务器

配置OpenAI API设置和凭据。

参数：

• apiKey （必需）：OpenAI API密钥
• organization：OpenAI组织ID
• model：使用型号（gpt-4.1-mini、gpt-4.1、gpt-4o、gpt-40-mini）

3.编辑图像

使用以前的响应ID编辑现有图像。

参数：

• editPrompt （必填）：编辑说明
• previousResponseId：用于多回合编辑的先前响应ID
• imageId：要编辑的特定图像ID

4.流图像

通过流媒体生成图像，以获得更快的反馈。

参数：

• prompt （必填）：图像描述
• partialImages：部分图像数量（1-3）
• size：图像尺寸

5.获取配置状态

检查当前配置状态。

6.列出支持的型号

列出所有支持的OpenAI模型用于图像生成。

文件管理

• 图像保存到 ~/Desktop 具有唯一的文件名
• 元数据存储在JSON sidecar文件中
• 自动清理旧图像（保留最后50张）
• 命名约定： openai-image-{timestamp}-{randomId}.{extension}

错误处理

服务器通过以下方式提供全面的错误处理：

• 配置验证
• API密钥验证
• 网络错误恢复
• 文件系统错误处理
• 有用的错误消息和建议

安全

• API密钥安全地存储在内部配置中
• 不记录敏感信息
• 所有输入的验证
• 安全的文件系统操作

发展

项目结构

src/
├── index.ts            # Main entry point
├── server.ts           # MCP server implementation
├── config-manager.ts   # Configuration management
├── image-generator.ts  # OpenAI API integration
├── file-manager.ts     # Desktop file operations
└── types.ts           # TypeScript definitions

建筑

npm run build

测试

npm test

需求

• Node.js 18+
• OpenAI API密钥
• 写入桌面权限
• 对OpenAI API的网络访问

重要通知

⚠️ 计费警告⚠️

OpenAI为所有成功的API请求付费，即使此MCP服务器的技术问题阻碍了可用结果的交付。这意味着，即使MCP服务器因错误、配置问题或其他技术问题而无法正确生成或保存图像，OpenAI也可能会向您收费。我们不保证或承担使用此MCP服务器可能产生的任何费用。使用风险自负。

请监控您的OpenAI API使用情况和账单，以避免意外收费。

许可证

麻省理工学院