
@cloudwerxlab/gpt-image-1-mcp

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 服务器,专注于图像生成和编辑功能。
核心功能
- 图像生成:通过文本提示生成新的图像。
- 图像编辑:基于文本提示和可选掩码编辑现有图像。
- 自动保存:所有生成的图像会自动保存到指定目录。
- 详细元数据:返回包含图像路径、令牌使用情况等详细信息的响应。
- 跨平台支持:支持 Windows、macOS 和 Linux 系统。
适用场景
- 创意设计:快速生成概念图或艺术创作。
- 内容创作:为博客、社交媒体等生成配图。
- 原型设计:快速创建产品原型或界面设计。
- 图像处理:对现有图像进行修改或增强。
工具列表
- create_image:
- 功能:根据文本提示生成新图像。
- 参数:支持设置图像大小、质量、数量、背景样式等。
- create_image_edit:
- 功能:编辑现有图像。
- 参数:支持指定图像、编辑提示、掩码、大小、质量等。
常见问题解答
- MIME 类型错误:确保图像文件扩展名与实际格式匹配。
- API 密钥问题:验证 OpenAI API 密钥是否正确且有访问权限。
- 构建错误:确保安装了正确版本的 TypeScript 和所有依赖项。
- 输出目录问题:检查是否有写入权限,尝试使用绝对路径。
使用教程
使用依赖
- Node.js:v14 或更高版本。
- OpenAI API 密钥:需要有访问 gpt-image-1 模型的权限。
安装教程
- 通过 NPX 运行(无需安装):
bash npx -y @cloudwerxlab/gpt-image-1-mcp
- 全局安装:
bash npm install -g @cloudwerxlab/gpt-image-1-mcp
调试方式
- 设置环境变量:
- Linux/macOS:
bash export OPENAI_API_KEY=sk-your-openai-api-key export GPT_IMAGE_OUTPUT_DIR=/path/to/output
- Windows (PowerShell):
powershell $env:OPENAI_API_KEY = "sk-your-openai-api-key" $env:GPT_IMAGE_OUTPUT_DIR = "C:\path\to\output"
- Windows (CMD):
cmd set OPENAI_API_KEY=sk-your-openai-api-key set GPT_IMAGE_OUTPUT_DIR=C:\path\to\output
- 运行服务器:
bash npx -y @cloudwerxlab/gpt-image-1-mcp
- 验证输出:检查指定输出目录中是否有生成的图像。