这是一款先进的MCP服务器，利用OpenAI的推理模型提供智能网页搜索功能。非常适合需要最新信息且具备智能推理能力的AI助手。

✨ 特色

• ** 🧠 推理模型支持**：完全兼容OpenAI最新的推理模型（gpt-5、gpt-5-mini、gpt-5-nano、o3、o4-mini）
• ** ⚡ 智能工作控制**：基于用例的智能reasoning_effort默认设置
• ** 🔄 多模式搜索**：使用GPT-5-mini进行快速迭代，或使用GPT-5进行深度研究
• ** 🌍 本地化结果**：支持基于位置的搜索定制
• ** 📝 丰富的描述**：完整的参数文档，便于集成
• ** 🔧 灵活配置**：支持环境变量，便于部署

🚀 快速启动

Claude桌面版一键安装

将sk-xxxx替换为OpenAI平台的OpenAI API密钥。

⚙️ 配置

克劳德桌面

添加你的claude_desktop_config.json：

光标

在光标中添加你的MCP设置：

1. 打开光标设置（Cmd/Ctrl + ,）
2. 搜索“MCP”或访问MCP分机→
3. 添加服务器配置：

克劳德·科德

OpenAI WebSearch MCP Server 🔍

An advanced MCP server that provides intelligent web search capabilities using OpenAI’s reasoning models. Perfect for AI assistants that need up-to-date information with smart reasoning capabilities.

✨ Features

• 🧠 Reasoning Model Support: Full compatibility with OpenAI’s latest reasoning models (gpt-5, gpt-5-mini, gpt-5-nano, o3, o4-mini)
• ⚡ Smart Effort Control: Intelligent reasoning_effort defaults based on use case
• 🔄 Multi-Mode Search: Fast iterations with gpt-5-mini or deep research with gpt-5
• 🌍 Localized Results: Support for location-based search customization
• 📝 Rich Descriptions: Complete parameter documentation for easy integration
• 🔧 Flexible Configuration: Environment variable support for easy deployment

🚀 Quick Start

One-Click Installation for Claude Desktop

OPENAI_API_KEY=sk-xxxx uvx --with openai-websearch-mcp openai-websearch-mcp-install

Replace sk-xxxx with your OpenAI API key from the OpenAI Platform.

⚙️ Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "openai-websearch-mcp": {
      "command": "uvx",
      "args": ["openai-websearch-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here",
        "OPENAI_DEFAULT_MODEL": "gpt-5-mini"
      }
    }
  }
}

Cursor

Add to your MCP settings in Cursor:

1. Open Cursor Settings (Cmd/Ctrl + ,)
2. Search for “MCP” or go to Extensions → MCP
3. Add server configuration:

{
  "mcpServers": {
    "openai-websearch-mcp": {
      "command": "uvx",
      "args": ["openai-websearch-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here",
        "OPENAI_DEFAULT_MODEL": "gpt-5-mini"
      }
    }
  }
}

Claude Code

Claude Code automatically detects MCP servers configured for Claude Desktop. Use the same configuration as above for Claude Desktop.

Local Development

For local testing, use the absolute path to your virtual environment:

{
  "mcpServers": {
    "openai-websearch-mcp": {
      "command": "/path/to/your/project/.venv/bin/python",
      "args": ["-m", "openai_websearch_mcp"],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here",
        "OPENAI_DEFAULT_MODEL": "gpt-5-mini",
        "PYTHONPATH": "/path/to/your/project/src"
      }
    }
  }
}

🛠️ Available Tools

openai_web_search

Intelligent web search with reasoning model support.

Parameters