@jhzhu89/mcp-server-web-search

MCP Server for web search via Azure OpenAI Responses API with web_search_preview tool.

Installation

Prerequisites

• Bun runtime installed

Claude Code (Recommended)

# Install globally (available in all projects)
claude mcp add web-search bunx @jhzhu89/mcp-server-web-search \
  -s user \
  -e AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com \
  -e AZURE_OPENAI_DEPLOYMENT=gpt-5-mini

# Or install for current project only (default)
claude mcp add web-search bunx @jhzhu89/mcp-server-web-search \
  -e AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com \
  -e AZURE_OPENAI_DEPLOYMENT=gpt-5-mini

Manual Configuration

Add to your .mcp.json:

{
  "mcpServers": {
    "web-search": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@jhzhu89/mcp-server-web-search"],
      "env": {
        "AZURE_OPENAI_ENDPOINT": "https://your-resource.openai.azure.com",
        "AZURE_OPENAI_DEPLOYMENT": "gpt-5-mini"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | AZURE_OPENAI_ENDPOINT | ✓ | - | Azure OpenAI endpoint URL | | AZURE_OPENAI_DEPLOYMENT | | gpt-5-mini | Deployment name | | AZURE_OPENAI_API_VERSION | | 2025-03-01-preview | API version |

Authentication

This server uses DefaultAzureCredential for Azure authentication. Supported methods:

1. Azure CLI (local development): Run az login before starting
2. Environment variables: Set AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET
3. Managed Identity: Works automatically in Azure environments

Tool: web_search

Search the web for real-time information with source citations.

Input

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | query | string | ✓ | Search query | | search_context_size | "low" | "medium" | "high" | | Amount of context (default: "medium") | | user_location | object | | {type, city, country, region, timezone} for localized results |

Output (structuredContent)

{
  "results": [
    {
      "query": "original search query",
      "text": "Answer text with inline [citations](url)...",
      "citations": [
        {
          "title": "Source Title",
          "url": "https://example.com",
          "start_index": 0,
          "end_index": 100
        }
      ]
    }
  ]
}

Development

# Clone and install
bun install

# Run locally
export AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
az login
bun run start

# Run with HTTP transport
bun run start:http

# Test
bun test

License

MIT