MCP HubMCP Hub
leehanchung

bing-search-mcp

by: leehanchung

MCP Server for Bing Search API

26created 15/03/2025
Visit
Bing
API

📌Overview

Purpose: To enable AI assistants to integrate seamlessly with Microsoft Bing Search API for performing various types of searches.

Overview: The Bing Search MCP Server is a Model Context Protocol server designed for integration with the Microsoft Bing Search API, facilitating web, news, and image searches for AI applications. It provides a structured environment for retrieving up-to-date information and images through a straightforward interface.

Key Features:

  • Web Search: Allows for a general search of information and content across the web, enhancing accessibility to data.

  • News Search: Retrieves recent news articles and timely information, keeping users informed about current events.

  • Image Search: Enables users to search for visual content, broadening the scope of search capabilities.

  • Rate Limiting: Implements mechanisms to prevent API abuse, ensuring fair usage.

  • Comprehensive Error Handling: Manages errors effectively to improve user experience and reliability of the search processes.


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 https://portal.azure.com/
  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