Bing Search MCP Server

What is Bing Search MCP Server about?

Provides a Model Context Protocol (MCP) server that wraps the Microsoft Bing Search API, exposing three tools—bing_web_search, bing_news_search, and bing_image_search—so AI assistants can retrieve up‑to‑date web content, news articles, and images directly from chat.

How to use Bing Search MCP Server?

1. Install the package in a Python 3.10+ environment (e.g., using uv venv and uv pip install -e .).
2. Configure the required environment variables:

   export BING_API_KEY="your-bing-api-key"
   # optional custom endpoint
   export BING_API_URL="https://api.bing.microsoft.com/"
   

3. Run the server with the convenience command:

   uvx bing-search-mcp
   

4. Add the server to a compatible MCP client (e.g., Claude Desktop) by specifying the command, arguments, and BING_API_KEY in the client’s configuration JSON.

Key features of Bing Search MCP Server

• Web search – retrieve up to 10 results per query with pagination support.
• News search – fetch recent articles filtered by freshness (Day, Week, Month).
• Image search – return image metadata and URLs for visual content.
• Rate limiting – built‑in throttling to protect the Bing API quota.
• Robust error handling – clear error messages for missing keys, quota issues, or network failures.

Use cases of Bing Search MCP Server

• Augmenting conversational agents with real‑time factual information.
• Providing up‑to‑date news summaries within a chat workflow.
• Supplying relevant images for visual explanations or design suggestions.
• Enabling automated research bots that need to browse the web safely.

FAQ from the Bing Search MCP Server

Q: Do I need a Bing API key? A: Yes, a valid key from Azure’s Bing Search resource is required and must be set in BING_API_KEY.

Q: Can I change the API endpoint? A: Optional; set BING_API_URL to a custom endpoint if needed.

Q: Which Python version is supported? A: Python 3.10 or higher.

Q: How do I integrate with Claude Desktop? A: Add an entry under mcpServers in claude_desktop_config.json pointing to the installed command and include BING_API_KEY in the env section.

Bing Search MCP Server

A Model Context Protocol (MCP) server for Microsoft Bing Search API integration, allowing AI assistants to perform web, news, and image searches.

Features

• Web search for general information
• News search for recent events and timely information
• Image search for visual content
• Rate limiting to prevent API abuse
• Comprehensive error handling

Requirements

• Python 3.10 or higher
• Microsoft Bing Search API key
• MCP-compatible client (e.g., Claude Desktop, Cursor)

Installation

1. Clone this repository
2. Install dependencies:

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   uv pip install -e .
   

Configuration

Set the required environment variables:

export BING_API_KEY="your-bing-api-key"
export BING_API_URL="https://api.bing.microsoft.com/"  # Optional

For Windows:

set BING_API_KEY=your-bing-api-key
set BING_API_URL=https://api.bing.microsoft.com/

Usage

Running the server

uvx bing-search-mcp

Configuring with Claude for Desktop

Add the following to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "bing-search": {
      "command": "uvx",
      "args": [
        "/path/to/your/bing-search-mcp"
      ],
      "env": {
        "BING_API_KEY": "your-bing-api-key"
      }
    }
  }
}

Available Tools

1. bing_web_search

General web search for information, websites, and content.

bing_web_search(query: str, count: int = 10, offset: int = 0, market: str = "en-US")

2. bing_news_search

Search for news articles and current events.

bing_news_search(query: str, count: int = 10, market: str = "en-US", freshness: str = "Day")

3. bing_image_search

Search for images.

bing_image_search(query: str, count: int = 10, market: str = "en-US")

Getting a Bing API Key

1. Visit Microsoft Azure Portal
2. Create or sign in to your Azure account
3. Create a new Bing Search resource
4. Go to the resource and find your API key in the "Keys and Endpoint" section

License

MIT License