Skip to main content
Glama
jhzhu89

@jhzhu89/mcp-server-web-search

by jhzhu89
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@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"
      }
    }
  }
}

Related MCP server: Tavily Web Search MCP Server

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

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jhzhu89/mcp-server-web-search'

If you have feedback or need assistance with the MCP directory API, please join our Discord server