Websearch Mcp Server
What is Websearch Mcp Server
websearch-mcp-server is a simple MCP server designed for agent web search, enabling users to perform web searches and convert URL content into Markdown format.
Use cases
Use cases include developing web applications that require search functionalities, generating Markdown documentation from web content, and integrating web search features into existing software solutions.
How to use
To use websearch-mcp-server, clone the repository, install the dependencies, configure the .env file with your desired settings, and run the server using either uv or Python.
Key features
Key features include web search capabilities using Bing as the search provider and the ability to convert URL content to Markdown format.
Where to use
websearch-mcp-server can be used in fields such as web development, content management, and any application requiring web search functionality and content formatting.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Websearch Mcp Server
websearch-mcp-server is a simple MCP server designed for agent web search, enabling users to perform web searches and convert URL content into Markdown format.
Use cases
Use cases include developing web applications that require search functionalities, generating Markdown documentation from web content, and integrating web search features into existing software solutions.
How to use
To use websearch-mcp-server, clone the repository, install the dependencies, configure the .env file with your desired settings, and run the server using either uv or Python.
Key features
Key features include web search capabilities using Bing as the search provider and the ability to convert URL content to Markdown format.
Where to use
websearch-mcp-server can be used in fields such as web development, content management, and any application requiring web search functionality and content formatting.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
