<!-- mcp-name: io.github.HughesCuit/heventure-search-mcp -->

中文 | 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.