AI导哈

图像生成服务器

一个集成OpenAI图像生成API的服务器，用于创建、编辑和流式传输图像，并自动保存到桌面。

  • by AiondaDotCom
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 aiondadotcom/mcp-openai-image

使用说明

MCP OpenAI图像生成服务器

模型上下文协议（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使用情况和账单，以避免意外收费。

许可证

麻省理工学院

相关 MCP