🚀 OpenAI MCP 服务器

本项目可通过MCP协议直接从Claude查询OpenAI模型。此分支增加了对o3 - mini和gpt - 4o - mini模型的支持，并改进了消息处理，为用户提供更丰富的模型选择和更优质的使用体验。

🚀 快速开始

安装步骤

1. 克隆仓库：

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

2. 安装依赖项：

pip install -r requirements.txt

3. 运行服务器：

python -m src.openai_mcp_server --openai-api-key your_api_key_here

配置说明

在 clint_mcp_settings.json 中添加以下内容：

{
  "servers": {
    "github.com/thadius83/mcp-server-openai": {
      "type": "tcp",
      "host": "localhost",
      "port": 5000
    }
  },
  "tools": {
    "ask-openai": {
      "server": "github.com/thadius83/mcp-server-openai",
      "tool": "ask-openai"
    }
  }
}

✨ 主要特性

1. 支持的模型：
   • o3 - mini（默认）：适合快速、简洁的回答。
   • gpt - 4o - mini：适合更全面、详细的解释。
2. 改进的消息格式：响应以结构化的JSON格式返回，包含类型和内容。

💻 使用示例

基础用法

在Claude中使用以下命令：

<use_mcp_tool>
<server_name>github.com/thadius83/mcp-server-openai</server_name>
<tool_name>ask-openai</tool_name>
<arguments>
{
  "query": "Python的asyncio库的关键特性是什么？",
  "model": "o3-mini" // 可选，默认为o3-mini
}
</arguments>
</use_mcp_tool>

高级用法

<use_mcp_tool>
<server_name>github.com/thadius83/mcp-server-openai</server_name>
<tool_name>ask-openai</tool_name>
<arguments>
{
  "query": "请详细解释Python的asyncio库的工作原理和应用场景",
  "model": "gpt-4o-mini"
}
</arguments>
</use_mcp_tool>

📚 详细文档

模型对比

响应格式

工具返回响应的标准格式：

{
  "content": [
    {
      "type": "text",
      "text": "模型的回答..."
    }
  ]
}

故障排除

⚠️ 重要提示

• 若遇到服务器未找到的问题，需确保配置文件中的PYTHONPATH正确，并检查Python和pip是否安装正常。
• 若出现身份验证错误，要确认OpenAI API密钥有效。
• 若出现模型错误，需确保使用支持的模型（o3 - mini或gpt - 4o - mini）。

🔧 技术细节

开发说明

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest -v test_openai.py -s

📄 许可证

文档中未提及许可证相关信息，若有需要可进一步补充。

🔄 变更日志

• 添加了对o3 - mini和gpt - 4o - mini模型的支持。
• 改进了消息处理机制。