mcpField
W
WebSearch MCP Server

WebSearch MCP Server

Local
github.com/Howe829Search15Updated 73w ago
Repository

About WebSearch MCP Server

WebSearch MCP Server lets agents search the web and convert URL content to Markdown. It also searches WeChat Official Account articles and GitHub.

Key features

  1. 01Search with Bing, Baidu, or Google
  2. 02Convert URL content to Markdown
  3. 03Search WeChat Official Account articles
  4. 04Search GitHub repositories, users, and issues

Use cases

  1. 01Searching the web through an agent
  2. 02Turning a webpage into Markdown
  3. 03Finding WeChat articles or GitHub content

MCP support

Exposes web search, URL-to-Markdown conversion, WeChat article search, and GitHub search as MCP server capabilities.

#websearch#mcp-server#markdown-converter

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.