OpenAI MCP 服务器

使用 MCP 协议直接从 Claude 查询 OpenAI 模型。此分支增加了对 o3-mini 和 gpt-4o-mini 模型的支持，并改进了消息处理。

Cline 自动安装

Set up the MCP server from https://github.com/thadius83/mcp-server-openai. 
Use "github.com/thadius83/mcp-server-openai" as the server name in cline_mcp_settings.json.
Analyse the readme and instructions below. Do not create new files in the repo, utilise the findings from pyproject.toml, src/mcp_server_openai/server.py, src/mcp_server_openai/llm.py
Once installed, demonstrate the server's capabilities by using one of its tools.

Installation Steps:
# Clone the repository
git clone https://github.com/thadius83/mcp-server-openai
cd mcp-server-openai

# Install the package
pip install .`

MCP Settings Configuration: The cline_mcp_settings.json should be configured with:
Correct server name format: "github.com/thadius83/mcp-server-openai"
Python module path structure for the server
PYTHONPATH environment variable pointing to the project directory
OpenAI API key passed as a command line argument

Example configuration:
{
  "mcpServers": {
    "github.com/thadius83/mcp-server-openai": {
      "command": "python",
      "args": [
        "-m",
        "src.mcp_server_openai.server",
        "--openai-api-key",
        "your-openai-api-key"
      ],
      "env": {
        "PYTHONPATH": "/path/to/mcp-server-openai"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Requirements:
Python >= 3.10
OpenAI API key
Dependencies installed via pip (mcp>=0.9.1, openai>=1.0.0, click>=8.0.0, pytest-asyncio)

Available Tools:
Tool Name: ask-openai
Description: Ask OpenAI assistant models a direct question
Models Available:
o3-mini (default)
gpt-4o-mini
Input Schema:
{
  "query": "Your question here",
  "model": "o3-mini" // optional, defaults to o3-mini
}

功能

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

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 OpenAI MCP 服务器：

npx -y @smithery/cli install @thadius83/mcp-server-openai --client claude

手动安装

1. 克隆仓库：

git clone https://github.com/thadius83/mcp-server-openai.git
cd mcp-server-openai

# Install dependencies
pip install -e .

1. 配置 Claude Desktop：

将此服务器添加到您现有的 MCP 设置配置中。注意：保留现有 MCP 服务器在配置中的位置 - 只需将此服务器添加到它们旁边即可。

位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json
• Linux: 检查您的主目录 (~/) 中的默认 MCP 设置位置

{
  "mcpServers": {
    // ... keep your existing MCP servers here ...
    
    "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"
      }
    }
  }
}

1. 获取 OpenAI API 密钥：

   • 访问 OpenAI 网站
   • 创建账户或登录
   • 导航至 API 设置
   • 生成新的 API 密钥
   • 将密钥添加到配置文件中，如上所示

2. 重启 Claude：

   • 更新配置后，重新启动 Claude 使更改生效

使用

该服务器提供了一个名为 ask-openai 的工具，可用于查询 OpenAI 模型。您可以直接在 Claude 中使用 use_mcp_tool 命令来使用它：

<use_mcp_tool>
<server_name>github.com/thadius83/mcp-server-openai</server_name>
<tool_name>ask-openai</tool_name>
<arguments>
{
  "query": "What are the key features of Python's asyncio library?",
  "model": "o3-mini"  // Optional, defaults to o3-mini
}
</arguments>
</use_mcp_tool>

模型比较

1. o3-mini（默认）

   • 最适合：快速、简洁的回答
   • 风格：直接且高效
   • 示例响应：

     Python 的 asyncio 提供非阻塞、协作式的多任务处理。主要特点：
     1. 事件循环 – 调度并运行异步任务
     2. 协程 – 可暂停和恢复的函数
     3. 任务 – 并发运行协程
     4. 期货 – 表示未来的结果
     5. 非阻塞 I/O – 高效处理 I/O 操作
     

2. gpt-4o-mini

   • 最适合：更全面的解释
   • 风格：详细且详尽
   • 示例响应：

     Python 的 asyncio 库提供了异步编程的全面框架。
     它包括一个用于管理任务的事件循环、用于编写非阻塞代码的协程、
     用于并发执行的任务、用于处理未来结果的期货以及高效的 I/O 操作。
     该库还提供了同步原语和用于网络编程的高级 API。
     

响应格式

该工具以标准化格式返回响应：

{
  "content": [
    {
      "type": "text",
      "text": "Response from the model..."
    }
  ]
}

故障排除

1. 找不到服务器:

   • 确认您的配置中的 PYTHONPATH 指向正确的目录
   • 确保 Python 和 pip 已正确安装
   • 尝试直接运行 python -m src.mcp_server_openai.server --openai-api-key your-key-here 以检查错误

2. 认证错误:

   • 检查您的 OpenAI API 密钥是否有效
   • 确保密钥在 args 数组中正确传递
   • 确认密钥中没有多余的空格或字符

3. 模型错误:

   • 确认您使用的是支持的模型 (o3-mini 或 gpt-4o-mini)
   • 检查您的查询是否为空
   • 确保您没有超过令牌限制

开发

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest -v test_openai.py -s

与原始版本的变化

• 增加了对 o3-mini 和 gpt-4o-mini 模型的支持
• 改进了消息格式
• 移除了温度参数以提高兼容性
• 更新了文档，包含详细的使用示例
• 添加了模型比较和响应示例
• 增强了安装说明
• 添加了故障排除指南

许可证

MIT 许可证