内容
# OpenAIMCP
一个使用 [AceDataCloud](https://platform.acedata.cloud) 的 [模型上下文协议（MCP）](https://modelcontextprotocol.io) 服务器，用于访问 OpenAI API。
直接从 Claude、VS Code 或任何兼容 MCP 的客户端与 OpenAI 模型交互，进行聊天完成、图像生成、文本嵌入等操作。
## 功能
- **聊天完成** — 访问 GPT-4、GPT-4o、GPT-5、o1、o3、o4-mini 等众多模型
- **响应 API** — 扩展模型变体支持，包括已发布模型和搜索预览模型
- **图像生成** — 使用 gpt-image-1、gpt-image-2、dall-e-3 和 nano-banana 模型创建图像
- **图像编辑** — 使用 AI 修改现有图像
- **文本嵌入** — 使用 text-embedding-3 模型生成向量表示
## 快速入门
### 前提条件
从 [AceDataCloud](https://platform.acedata.cloud) 获取 API 令牌。
### 安装
```bash
pip install mcp-openai
```
### 配置
设置您的 API 令牌：
```bash
export ACEDATACLOUD_API_TOKEN=your_api_token_here
```
### 运行
```bash
mcp-openai
```
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `openai_chat_completion` | 使用 OpenAI 模型创建聊天完成 |
| `openai_create_response` | 使用响应 API 创建响应 |
| `openai_generate_image` | 根据文本描述生成图像 |
| `openai_edit_image` | 使用 AI 编辑现有图像 |
| `openai_create_embedding` | 创建文本嵌入向量 |
| `openai_list_chat_models` | 列出可用的聊天/完成模型 |
| `openai_list_image_models` | 列出可用的图像模型 |
| `openai_list_embedding_models` | 列出可用的嵌入模型 |
| `openai_get_usage_guide` | 获取综合使用指南 |
## 支持的模型
### 聊天完成模型
- **GPT-5 系列**：gpt-5.5、gpt-5.5-pro、gpt-5.4、gpt-5.4-pro、gpt-5.2、gpt-5.1、gpt-5、gpt-5-mini、gpt-5-nano
- **GPT-4 系列**：gpt-4.1、gpt-4.1-mini、gpt-4.1-nano、gpt-4o、gpt-4o-mini、gpt-4
- **推理**：o4-mini、o3、o3-mini、o3-pro、o1、o1-mini、o1-pro
### 图像模型
- gpt-image-1、gpt-image-1.5、gpt-image-2、dall-e-3、dall-e-2、nano-banana、nano-banana-2、nano-banana-pro
### 嵌入模型
- text-embedding-3-small、text-embedding-3-large、text-embedding-ada-002
## 使用示例
### 聊天完成
```
openai_chat_completion(
messages=[{"role": "user", "content": "用简单的术语解释量子计算"}],
model="gpt-4.1"
)
```
### 图像生成
```
openai_generate_image(
prompt="日落时分带有樱花的宁静的日本庭院，照片逼真",
model="gpt-image-1",
size="1024x1024"
)
```
### 文本嵌入
```
openai_create_embedding(
input="The quick brown fox jumps over the lazy dog",
model="text-embedding-3-small"
)
```
## 配置
| 变量 | 描述 | 默认值 |
|----------|-------------|---------|
| `ACEDATACLOUD_API_TOKEN` | API 令牌（必填） | — |
| `ACEDATACLOUD_API_BASE_URL` | API 基址 | `https://api.acedata.cloud` |
| `OPENAI_REQUEST_TIMEOUT` | 请求超时（秒） | `60` |
| `MCP_SERVER_NAME` | MCP 服务器名称 | `openai` |
| `LOG_LEVEL` | 日志级别 | `INFO` |
## 开发
```bash
# 安装依赖
pip install -e ".[dev,test]"
# 运行测试
pytest
# 运行 linter
ruff check .
```
## API 参考
- [AceDataCloud 平台](https://platform.acedata.cloud)
- [OpenAI API 文档](https://platform.openai.com/docs)
## 许可证
MIT
