MCP Server Openai

🚀 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模型的支持。
• 改進了消息處理機制。