Skip to main 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

  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

Metadata

Release files for iflow-mcp_howe829-websearch-mcp-server 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_howe829-websearch-mcp-server 0.1.3
File Size Uploaded Provenance Actions
iflow_mcp_howe829_websearch_mcp_server-0.1.3.tar.gz 9.2 kB Without provenance Details for iflow_mcp_howe829_websearch_mcp_server-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_howe829-websearch-mcp-server 0.1.3
File Interpreter ABI Platform Actions
iflow_mcp_howe829_websearch_mcp_server-0.1.3-py3-none-any.whl Python 3 none any Details for iflow_mcp_howe829_websearch_mcp_server-0.1.3-py3-none-any.whl

Total release size: 24.0 kB

Release files / iflow_mcp_howe829_websearch_mcp_server-0.1.3.tar.gz

Download URL iflow_mcp_howe829_websearch_mcp_server-0.1.3.tar.gz
Size 9.2 kB
Tags Source
SHA-256 checksum
How to use checksums
c40cd5f1ec0f4460ce62c6df8f58b7a1c7b336fd2daad2439399bf43614cd74c
BLAKE2b-256 checksum
How to use checksums
99898b624b9f8f473598ad2deeb343ca676463b1bb65ddf3b0c7106c20527ef0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / iflow_mcp_howe829_websearch_mcp_server-0.1.3-py3-none-any.whl

Download URL iflow_mcp_howe829_websearch_mcp_server-0.1.3-py3-none-any.whl
Size 14.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6ece7955907afaed086bd82571d972acaca0147b81d064bdd89b1134b9ef6877
BLAKE2b-256 checksum
How to use checksums
a6d2137729aefefc92d7c9d9363be4652527cdd2fac5e3c0f9f5fc5355e5c38a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for iflow-mcp_howe829-websearch-mcp-server 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page