内容
# 🎨 gpt-image-mcp
在 **Claude Code** 中直接生成和编辑图像，使用 **gpt-image-2** — OpenAI 最新的图像模型（具备推理能力，适合处理带有可读文本的图像）。
您可以用普通中文下达指令（例如“生成一个绿色调的金融应用的mockup”），图像就会直接生成并保存在您电脑的指定文件夹中。无需访问网站，无需复制粘贴，无需中间人 — 服务器直接调用OpenAI的API。
> **不是程序员？没问题。** 💚
> 本项目旨在通过 **Claude Code** 的帮助进行安装。打开 **Claude Code**，粘贴以下命令，它将为您完成所有操作：
>
> ```
> 为我安装这个仓库的MCP：https://github.com/anagesoares/gpt-image-mcp
> 请阅读README和CLAUDE.md，并一步步指导我。
> ```
## 功能
| 工具 | 功能 |
|---|---|
| `generate_image` | 根据文本（提示）生成图像。支持选择大小、质量、格式、透明背景，一次最多生成10张图像。 |
| `edit_image` | 编辑您电脑中已有的图像 — 修改文本、更改样式、合并参考，进行蒙版修复。 |
## 费用
费用直接在您的 **OpenAI 账户** 中扣除（您需要拥有带有积分的API密钥）。预估每张图像的费用：
| 质量 | 价格 | 适用场景 |
|---|---|---|
| `low` | 约 $0.006 | 草稿、创意测试 |
| `medium`（默认） | 约 $0.024 | 社交媒体帖子、mockups、缩略图 — 已经相当不错 |
| `high` | 约 $0.21 | 需要最高质量时使用 |
## 安装（步骤指南）
### 1. 克隆项目
```bash
git clone https://github.com/anagesoares/gpt-image-mcp.git
cd gpt-image-mcp
npm install
```
### 2. 保存您的OpenAI密钥
在 [platform.openai.com/api-keys](https://platform.openai.com/api-keys) 获取您的API密钥。
**在Mac（推荐）**：将其保存在Keychain中，这样密钥就不会出现在任何文件中：
```bash
security add-generic-password -a "$USER" -s openai-gpt-image -w
```
（会要求您粘贴密钥 — 粘贴并回车）
**在其他系统**：定义环境变量 `OPENAI_API_KEY`（可以在步骤3的 `env` 块中传递）。
### 3. 在Claude Code中注册
将以下内容添加到 `~/.claude.json` 文件的 `mcpServers` 部分：
```json
{
"mcpServers": {
"gpt-image": {
"command": "node",
"args": ["/完整路径/到/gpt-image-mcp/server.js"],
"env": {
"GPT_IMAGE_OUTPUT_DIR": "/保存图像的文件夹路径"
}
}
}
}
```
- 将 `/完整路径/到/` 替换为克隆仓库的位置。
- `GPT_IMAGE_OUTPUT_DIR` 为可选参数 — 如果未设置，图像将保存到 `~/Documents/gpt-image`。
### 4. 重启Claude Code
关闭并重新打开 **Claude Code**。现在，您可以用自然语言请求图像，Claude Code将自动使用该工具。
```
生成一张1536x1024的舒适办公室图像，带有“专注于重要的事情”的标志，质量为中等。
```
## 常见问题
**我需要OpenAI付费账户吗？** 需要一个带有积分的API密钥（与ChatGPT Plus分开）。请在platform.openai.com → Billing查看。
**在Windows/Linux上能用吗？** 可以 — 只有Keychain部分是Mac独有的；在其他系统上使用 `OPENAI_API_KEY` 环境变量。
**图像保存在哪里？** 保存在您在 `GPT_IMAGE_OUTPUT_DIR` 中定义的目录（或 `~/Documents/gpt-image`）。Claude Code始终会显示每个生成文件的确切路径。
**出现错误怎么办？** 服务器的错误消息已经包含解决方法（无效密钥、积分耗尽、无模型访问权限）。如果卡住，请在Claude Code中粘贴错误消息并寻求帮助。
---
由 [Ana G. Soares](https://instagram.com/ana.gsoares) 使用Claude Code创建 · [MIT](LICENSE) 许可证
