WebSearch MCP Server

A simple web search server that supports free search and converts URL content to Markdown. 中文

Features

• Web Search: Perform web searches using different providers. Supported providers: Bing, Baidu, Google(with browser_use).

• Markdown Conversion: Convert the content of a URL into Markdown format.

• Wechat Official Account Articles: Search and retrive wechat official account articles content.

• GitHub Search: Easily search for anything on GitHub — repositories, users, issues, and more.

Getting Started

Prerequisites

• Python 3.12 or higher

• uv for dependency management (or pip)

Installation

1. Clone the repository:

   git clone https://github.com/Howe829/websearch-mcp-server.git cd websearch-mcp-server

2. Install the dependencies using uv (Recomend):

   uv venv && uv sync

   Or, if you prefer using pip:

   pip install -r requirements.txt

Configuration

1. Create a .env file based on the .env.example file:

   cp .env.example .env

2. Modify the .env file with your desired settings:

   BING_SEARCH_BASE_URL="https://www.bing.com" LANGUAGE="en" CC="us" IMPERSONATE="edge" HOST=127.0.0.1 PORT=8002 SERVER_MODE=streamable-http

Usage

Run the server using uv:

Or run the server using python:

Contribution

Contributions are welcome!

This project uses pytest for unit tests

And use the ruff for code sytle formatting

use mcp inpector to debug this server