Install
$ agentstack add mcp-howe829-websearch-mcp-server ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ● Environment & secrets Used
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
WebSearch MCP Server
A simple web search server that supports free search and converts URL content to Markdown. [中文](README-zh.md)
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:
``bash git clone https://github.com/Howe829/websearch-mcp-server.git cd websearch-mcp-server ``
- Install the dependencies using uv (Recomend):
``bash uv venv && uv sync ``
Or, if you prefer using pip:
``bash pip install -r requirements.txt ``
Configuration
- Create a
.envfile based on the.env.examplefile:
``bash 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
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: Howe829
- Source: Howe829/websearch-mcp-server
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.