内容
# MCP OpenAI 图片生成器
MCP 服务器，封装了 OpenAI 的图片生成 API。
## 工具列表
| 工具 | 描述 |
|------|-------------|
| `generate_image` | 使用 gpt-image-2 根据文本提示生成图片 |
| `list_generated_images` | 列出输出文件夹中所有已生成的图片 |
| `load_image` | 加载并内联显示已保存的图片 |
## 设置
### 1. 构建
```bash
npm install
npm run build
```
### 2. 配置
环境变量:
| 变量 | 默认值 | 描述 |
|----------|---------|-------------|
| `OPENAI_API_KEY` | *(必填)* | 您的 OpenAI API 密钥 |
| `OPENAI_BASE_URL` | *(可选)* | 自定义基础 URL（例如自托管代理）；默认为官方 OpenAI 端点 |
| `IMAGE_OUTPUT_DIR` | `./generated_images` | 保存生成的图片的目录 |
### 3. 在 Claude Desktop / Kiro CLI 中注册
添加到您的 MCP 配置（例如 `~/.claude/mcp.json` 或 Claude Desktop `claude_desktop_config.json`）：
```json
{
"mcpServers": {
"openai-image": {
"command": "node",
"args": ["D:/project/fully_async/mcp-openai-image/dist/index.js"],
"env": {
"OPENAI_API_KEY": "您的 OpenAI API 密钥",
"IMAGE_OUTPUT_DIR": "D:/project/fully_async/mcp-openai-image/generated_images"
}
}
}
}
```
## 使用示例
### 架构图
```
generate_image(
prompt = "AWS 微服务架构图：React SPA → API Gateway → 3 个 Lambda 函数（auth、orders、products）→ DynamoDB + S3。干净的白色背景，蓝色/橙色配色方案，用箭头连接，专业科技风格。",
size = "1536x1024",
quality = "高"
)
```
### 系统设计
```
generate_image(
prompt = "实时聊天应用系统设计图：WebSocket 服务器、Redis 发布/订阅、消息队列（Kafka）、PostgreSQL、媒体 CDN。黑暗背景，霓虹灯连接器，现代风格。",
size = "1536x1024",
quality = "中等"
)
```
## 支持的参数
| 参数 | 选项 | 默认值 |
|-----------|---------|---------|
| `size` | `1024x1024`、`1024x1536`、`1536x1024`、`auto` | `1024x1024` |
| `quality` | `低`、`中等`、`高`、`auto` | `中等` |
| `n` | 1–4 | `1` |
| `output_format` | `png`、`jpeg`、`webp` | `png` |
| `save_to_disk` | `true` / `false` | `true` |
| `output_dir` | 任意路径 | `./generated_images` |
