HughesCuit/heventure-search-mcp
π βοΈ π - Free MCP web search server with 5 engines (DuckDuckGo, Bing, Google SerpAPI, Tavily). No API key required. Auto rate limiting, 300s cache, multi-language support. Install: uvx heventure-search-mcp.
Quick Install
{
"mcpServers": {
"hughescuit-heventure-search-mcp": {
"command": "npx",
"args": [
"-y",
"hughescuit-heventure-search-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
δΈζ | 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.