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 sync
Or, 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
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.