Bing Web Search API

What is bing-search-mcp?

bing-search-mcp is a Model Context Protocol (MCP) server that integrates with the Microsoft Bing Search API. It allows AI assistants, such as Claude Desktop, to perform various types of searches including web, news, and image searches.

How to use bing-search-mcp?

To use bing-search-mcp, you need Python 3.10 or higher and a Microsoft Bing Search API key. First, clone the repository and install dependencies using uv venv and uv pip install -e .. Then, set your BING_API_KEY and optionally BING_API_URL as environment variables. You can run the server using uvx bing-search-mcp. For integration with Claude Desktop, you need to add a specific configuration to its claude_desktop_config.json file, specifying the command to run the MCP server and your Bing API key.

Key Features of bing-search-mcp

• Web search: General information retrieval.
• News search: Access to recent events and timely information.
• Image search: Visual content discovery.
• Rate limiting: Prevents API abuse.
• Comprehensive error handling: Ensures robust operation.

Use Cases of bing-search-mcp

• AI Assistant Integration: Enables AI assistants to perform real-time web, news, and image searches.
• Information Retrieval: Provides a programmatic way for applications to access Bing search capabilities.
• Content Generation: Can be used by AI models to gather information for generating diverse content.

FAQ from bing-search-mcp

Q: What are the available tools? A: The project provides three main tools:

• bing_web_search(query: str, count: int = 10, offset: int = 0, market: str = "en-US"): For general web searches.
• bing_news_search(query: str, count: int = 10, market: str = "en-US", freshness: str = "Day"): For searching news articles.
• bing_image_search(query: str, count: int = 10, market: str = "en-US"): For searching images.

Q: How do I get a Bing API Key? A: You can obtain a Bing API key by visiting the Microsoft Azure Portal, creating or signing in to your Azure account, creating a new Bing Search resource, and then finding your API key in the "Keys and Endpoint" section of the resource.

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