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

Terminal

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:

config.json

{
  "mcpServers": {
    "web-search": {
      "command": "uvx",
      "args": ["heventure-search-mcp"]
    }
  }
}

Option 2: Command Line

Terminal

pip install heventure-search-mcp
heventure-search-mcp

Option 3: Docker

Terminal

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:

server.ts

# 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.