heventure-search-mcp 1.2.1

一个无需API key的网页搜索MCP服务器，支持DuckDuckGo和必应搜索

中文 | English

---

MCP Web Search Server

A free, API-key-free web search MCP (Model Context Protocol) server supporting DuckDuckGo, Bing, and Google search engines.

Features

• 🔍 Multi-Engine Search: DuckDuckGo, Bing, Google support, no API key required
• 📄 Web Content Fetching: Get text content from any webpage
• 🚀 Async Processing: High-performance asyncio-based async handling
• 🛡️ Secure & Private: No external API keys needed, protects privacy

Installation

PyPI (Recommended)

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

uvx

uvx heventure-search-mcp

From Source

pip install git+https://github.com/HughesCuit/heventure-search-mcp.git
python -m server

Usage

MCP Client Config

{
  "mcpServers": {
    "web-search": {
      "command": "python",
      "args": ["/path/to/server.py"]
    }
  }
}

Trae AI

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

Available Tools

web_search

Search web content with multiple engines.

Parameters:

• query (string, required): Search query
• max_results (integer, optional): Max results (default: 10, range: 1-20)
• search_engine (string, optional): Engine choice (default: "both")
  • "duckduckgo": DuckDuckGo only
  • "bing": Bing only
  • "google": Google only
  • "both": All engines combined

Example:

{
  "query": "Python tutorial",
  "max_results": 5,
  "search_engine": "both"
}

get_webpage_content

Get text content from a webpage.

Parameters:

• url (string, required): Target webpage URL

Example:

{
  "url": "https://example.com"
}

Error Handling

• Automatic retry on network failure
• Graceful degradation on parse errors
• User-friendly error messages

License

MIT License

Contributing

Issues and Pull Requests are welcome!