WebSearch MCP Server
About
A web search server that supports free search via multiple providers and converts URL content into Markdown format. It is for developers who need search and content extraction capabilities in an MCP environment.
Details
- Author
- Howe829
- GitHub stars
- 15
- Downloads
- 397
- Categories
- Search
Jump to
- Web search via Bing, Baidu, and Google
- Convert URL content to Markdown
- Search Wechat Official Account Articles
- GitHub search (repos, users, issues)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
WebSearch MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install dependencies (using uv or pip), copy .env.example to .env and modify settings, then run python server.py (or uv run python server.py). No specific commands or config keys are required beyond the .env file.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"websearch mcp server": {
"websearch-mcp-server": {
"command": "uv",
"args": [
"venv",
"&&",
"uv",
"sync"
]
}
}
}
}McpServers
{
"websearch-mcp-server": {
"command": "uv",
"args": [
"venv",
"&&",
"uv",
"sync"
]
}
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
