@cloudwerxlab/gpt-image-1-mcp

@cloudwerxlab/gpt-image-1-mcp

site icon
2025.05.07 1
JavaScript图像生成图像编辑AI 创作内容生成
gpt-image-1-mcp 是一个基于 OpenAI 的 gpt-image-1 模型的 MCP(Model Context Protocol)服务器,用于生成和编辑图像。它提供了简单易用的接口,支持通过文本提示生成新图像或编辑现有图像,并可以无缝集成到各种 MCP 客户端中。
View on GitHub

Overview

基本能力

产品定位

gpt-image-1-mcp 是一个基于 OpenAI 的 gpt-image-1 模型的 MCP 服务器,专注于图像生成和编辑功能。

核心功能

  1. 图像生成:通过文本提示生成新的图像。
  2. 图像编辑:基于文本提示和可选掩码编辑现有图像。
  3. 自动保存:所有生成的图像会自动保存到指定目录。
  4. 详细元数据:返回包含图像路径、令牌使用情况等详细信息的响应。
  5. 跨平台支持:支持 Windows、macOS 和 Linux 系统。

适用场景

  1. 创意设计:快速生成概念图或艺术创作。
  2. 内容创作:为博客、社交媒体等生成配图。
  3. 原型设计:快速创建产品原型或界面设计。
  4. 图像处理:对现有图像进行修改或增强。

工具列表

  1. create_image
  2. 功能:根据文本提示生成新图像。
  3. 参数:支持设置图像大小、质量、数量、背景样式等。
  4. create_image_edit
  5. 功能:编辑现有图像。
  6. 参数:支持指定图像、编辑提示、掩码、大小、质量等。

常见问题解答

  1. MIME 类型错误:确保图像文件扩展名与实际格式匹配。
  2. API 密钥问题:验证 OpenAI API 密钥是否正确且有访问权限。
  3. 构建错误:确保安装了正确版本的 TypeScript 和所有依赖项。
  4. 输出目录问题:检查是否有写入权限,尝试使用绝对路径。

使用教程

使用依赖

  1. Node.js:v14 或更高版本。
  2. OpenAI API 密钥:需要有访问 gpt-image-1 模型的权限。

安装教程

  1. 通过 NPX 运行(无需安装): bash npx -y @cloudwerxlab/gpt-image-1-mcp
  2. 全局安装bash npm install -g @cloudwerxlab/gpt-image-1-mcp

调试方式

  1. 设置环境变量
  2. Linux/macOS: bash export OPENAI_API_KEY=sk-your-openai-api-key export GPT_IMAGE_OUTPUT_DIR=/path/to/output
  3. Windows (PowerShell): powershell $env:OPENAI_API_KEY = "sk-your-openai-api-key" $env:GPT_IMAGE_OUTPUT_DIR = "C:\path\to\output"
  4. Windows (CMD): cmd set OPENAI_API_KEY=sk-your-openai-api-key set GPT_IMAGE_OUTPUT_DIR=C:\path\to\output
  5. 运行服务器bash npx -y @cloudwerxlab/gpt-image-1-mcp
  6. 验证输出:检查指定输出目录中是否有生成的图像。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。