OpenAI MCP Server

基本能力

产品定位

OpenAI MCP Server 是一个通过 MCP 协议直接查询 OpenAI 模型的服务，支持 o3-mini 和 gpt-4o-mini 模型，提供简洁和详细的回答。

核心功能

• 直接集成 OpenAI API
• 支持多种模型：
• o3-mini（默认）：优化简洁回答
• gpt-4o-mini：提供更详细的回答
• 可配置的消息格式化
• 错误处理和日志记录
• 通过 MCP 协议提供简单接口

适用场景

• 快速获取简洁回答
• 需要详细解释的场景
• 开发中需要集成 OpenAI 模型的场景

工具列表

• ask-openai：直接向 OpenAI 助手模型提问
• 输入格式： json { "query": "Your question here", "model": "o3-mini" // 可选，默认为 o3-mini }

常见问题解答

1. 服务器未找到：
2. 检查 PYTHONPATH 是否指向正确目录
3. 确保 Python 和 pip 已正确安装
4. 直接运行 python -m src.mcp_server_openai.server --openai-api-key your-key-here 检查错误
5. 认证错误：
6. 检查 OpenAI API 密钥是否有效
7. 确保密钥正确传递到 args 数组
8. 验证密钥中没有多余空格或字符
9. 模型错误：
10. 确认使用支持的模型（o3-mini 或 gpt-4o-mini）
11. 检查查询是否为空
12. 确保未超过令牌限制

使用教程

使用依赖

• Python >= 3.10
• OpenAI API 密钥
• 依赖项：mcp>=0.9.1, openai>=1.0.0, click>=8.0.0, pytest-asyncio

安装教程

1. 克隆仓库： bash git clone https://github.com/thadius83/mcp-server-openai cd mcp-server-openai
2. 安装依赖： bash pip install -e .
3. 配置 Claude Desktop：
4. 在 claude_desktop_config.json 中添加服务器配置
5. 示例配置： json { "mcpServers": { "github.com/thadius83/mcp-server-openai": { "command": "python", "args": ["-m", "src.mcp_server_openai.server", "--openai-api-key", "your-key-here"], "env": { "PYTHONPATH": "/path/to/your/mcp-server-openai" } } } }
6. 获取 OpenAI API 密钥：
7. 访问 OpenAI 网站 生成 API 密钥
8. 重启 Claude：
9. 更新配置后重启 Claude 使更改生效

调试方式

• 运行测试： bash pytest -v test_openai.py -s
• 直接运行服务器检查错误： bash python -m src.mcp_server_openai.server --openai-api-key your-key-here

许可证

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