About Heventure Search MCP
Heventure Search MCP is an MCP server published by HughesCuit in the AI category: free, API-key-free MCP web search server — DuckDuckGo, Bing, Google + optional SerpAPI/Tavily. Works with Claude Desktop, Cursor, and any MCP client.
The repository has 10 stars and 0 forks, with the last commit 5 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/HughesCuit/heventure-search-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Heventure Search MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
中文 | 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.
README fetched from the repository 5 days ago. The original is authoritative.