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:

uv run python server.py

Or run the server using python:

source .venv/bin/activate
python server.py

Contribution

Contributions are welcome!

This project uses pytest for unit tests

uv pip install pytest
uv pip install pytest-asyncio
uv run pytest

And use the ruff for code sytle formatting

uv pip install ruff
ruff format .

use mcp inpector to debug this server

uv run fastmcp dev server.py