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
-
Clone the repository:
git clone https://github.com/Howe829/websearch-mcp-server.git cd websearch-mcp-server -
Install the dependencies using uv (Recomend):
uv venv && uv syncOr, if you prefer using pip:
pip install -r requirements.txt
Configuration
-
Create a
.envfile based on the.env.examplefile:cp .env.example .env -
Modify the
.envfile 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