中文 | English
🔍 MCP Web Search Server
Free forever. No API key required. A web search MCP server that works out of the box with Claude Desktop, Cursor, and any MCP-compatible AI tool.
pip install heventure-search-mcp
✨ Why?
Most MCP search servers require you to sign up for API keys (Bing, Google, SerpAPI...). This one works immediately — zero configuration, zero cost, zero sign-ups.
| Feature | This Server | Others |
|---|---|---|
| No API key needed | ✅ | ❌ |
| DuckDuckGo (free) | ✅ | varies |
| Bing (free) | ✅ | ❌ |
| Google (free) | ✅ | ❌ |
| Optional SerpAPI/Tavily | ✅ | ✅ |
| Async + caching | ✅ | varies |
| Install in 10 seconds | ✅ | varies |
🚀 Quick Start
Option 1: Claude Desktop / Cursor
Add to your MCP config:
{
"mcpServers": {
"web-search": {
"command": "uvx",
"args": ["heventure-search-mcp"]
}
}
}
Option 2: Command Line
pip install heventure-search-mcp
heventure-search-mcp
Option 3: Docker
docker run -p 8080:8080 heventure-search-mcp
🔧 Available Tools
web_search
Search the web with multiple engines simultaneously.
| Parameter | Type | Default | Description |
|---|---|---|---|
query |
string | required | Search query |
max_results |
int | 10 | Number of results (1-20) |
search_engine |
string | "both" |
duckduckgo, bing, google, or both |
get_page_content
Extract readable text from any webpage.
| Parameter | Type | Default | Description |
|---|---|---|---|
url |
string | required | Page URL to fetch |
🔑 Optional: Enhanced Search
The free engines work great for most use cases. For higher quality results, you can optionally add paid API keys:
# SerpAPI — 100 free searches/month
export SERPAPI_KEY="your_key"
# Tavily — 1,000 free searches/month
export TAVILY_API_KEY="your_key"
🏗️ Architecture
- Engines: DuckDuckGo, Bing, Google, SerpAPI, Tavily
- Caching: LRU cache with 300s TTL (100 entries max)
- Protocol: MCP (Model Context Protocol)
- Runtime: Python 3.10+ with asyncio
🤝 Contributing
Issues and Pull Requests are welcome! See CONTRIBUTING.md for guidelines.
📄 License
MIT License — use it however you want.
1 maintainer
Metadata
1 maintainer
Release files for heventure-search-mcp 1.5.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 | |
|---|---|---|---|
| heventure_search_mcp-1.5.3.tar.gz | 65.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| heventure_search_mcp-1.5.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 82.5 kB
Release files / heventure_search_mcp-1.5.3.tar.gz
| Download URL | heventure_search_mcp-1.5.3.tar.gz |
|---|---|
| Size | 65.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eaf53dea3a2676f48d63b9e3d947af5c65af2d7e168ad393ab9b04fbcd9aeafa
|
|
BLAKE2b-256 checksum How to use checksums |
1ffc2804031324009fb5ea2cd6f138b41c5b654372375dfd3dc5ac3ef20bee6e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Release files / heventure_search_mcp-1.5.3-py3-none-any.whl
| Download URL | heventure_search_mcp-1.5.3-py3-none-any.whl |
|---|---|
| Size | 17.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
185b695a930b1687b200b2fe399f882f1e9aa0b8e8d968d304d76a2ed8546172
|
|
BLAKE2b-256 checksum How to use checksums |
c5f036cf11ed37de01a905ff417413913f33b728d413fa00a3b32f463700f2a9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
