Heventure Search MCP
中文 | English
MCP Web Search Server
一个免费、无需 API 密钥的 Web 搜索 MCP (Model Context Protocol) 服务器,支持 DuckDuckGo、Bing、Google,并可选配 SerpAPI/Tavily 以提升搜索质量。
功能特性
🔍 多引擎搜索:DuckDuckGo + Bing + Google(免费,无需 API 密钥)
🔑 可选 API 密钥:支持 SerpAPI 和 Tavily 以获得更好的搜索质量
📄 网页内容抓取:获取任意网页的文本内容
🚀 异步处理:基于 asyncio 的高性能异步处理
Related MCP server: Web Search MCP Server
安装
PyPI (推荐)
pip install heventure-search-mcp
heventure-search-mcpuvx
uvx heventure-search-mcp从源码安装
pip install git+https://github.com/HughesCuit/heventure-search-mcp.git
python -m server使用方法
MCP 客户端配置
{
"mcpServers": {
"web-search": {
"command": "python",
"args": ["/path/to/server.py"]
}
}
}Trae AI
{
"mcpServers": {
"heventure-search-mcp": {
"command": "uvx",
"args": ["heventure-search-mcp"]
}
}
}可用工具
web_search
使用多个引擎搜索网页内容。
参数:
query(字符串,必填):搜索查询词max_results(整数,可选):最大结果数(默认:10,范围:1-20)search_engine(字符串,可选):引擎选择(默认:"both")"duckduckgo":仅 DuckDuckGo"bing":仅 Bing"google":仅 Google"both":DuckDuckGo + Google + Bing
可选 API 密钥(用于增强搜索)
您可以选择设置环境变量来启用付费搜索引擎:
# SerpAPI (Google search results via API, 100 searches/month free)
export SERPAPI_KEY="your_serpapi_key"
# Tavily (AI-optimized search, 1000 searches/month free)
export TAVILY_API_KEY="your_tavily_api_key"配置 API 密钥后,系统将自动结合免费引擎使用它们,以提高搜索质量。
示例:
{
"query": "Python tutorial",
"max_results": 5,
"search_engine": "both"
}get_webpage_content
获取网页的文本内容。
参数:
url(字符串,必填):目标网页 URL
示例:
{
"url": "https://example.com"
}错误处理
网络故障时自动重试
解析错误时优雅降级
用户友好的错误提示
许可证
MIT License
贡献
欢迎提交 Issue 和 Pull Request!
Available Tools
2 toolsget_webpage_contentA
Extract readable text content from a specific webpage URL. Use this tool after web_search when you need the full text of a page found in search results. The tool strips scripts, styles, and navigation elements, returning only the meaningful text content. Output is truncated to 2000 characters to stay within context limits. Returns an empty string if the page cannot be fetched or parsed.
Inputs: url (required).
web_searchA
Search the web using multiple search engines. Use this tool when you need to find current information, articles, or references from the internet. Supports DuckDuckGo, Google, and Bing as free engines, with optional SerpAPI (requires SERPAPI_KEY env var) and Tavily (requires TAVILY_API_KEY env var) for higher-quality, more stable results. By default ('both'), queries DuckDuckGo and Bing concurrently and merges results, providing good coverage without any API keys. Each result includes title, URL, and description snippet. Rate limiting and caching are applied automatically.
Inputs: query (required), max_results, search_engine.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one searches the web, the other retrieves content from a specific URL. There is no overlap in functionality, and their descriptions make the differentiation explicit.
Both tool names follow a consistent verb_noun pattern: 'web_search' and 'get_webpage_content'. The naming is clear, predictable, and uses underscores consistently.
With only two tools, the server is minimal but well-scoped for a search-and-retrieve workflow. While more tools could be added (e.g., for advanced filtering or caching), the current count fits the server's stated purpose without being too thin.
The tool set covers the basic search workflow: find pages via web_search, then extract content via get_webpage_content. There are no obvious gaps for the intended use case of retrieving text from web pages.
Maintenance
Related MCP Connectors
Bing and DuckDuckGo results with snippets and readable page text for AI agents and RAG.
Google, Bing, DuckDuckGo and Google Maps search results, free without an API key.
Live web search and fetch plus Twitter, Reddit, GitHub, Amazon, YouTube, Telegram data. No API keys.
Web search and page reading for AI agents: search, fetch, scrape, map and crawl, with sources.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables browser automation using Puppeteer through the MCP interface. Allows launching browsers, creating pages, and executing arbitrary JavaScript for web scraping, testing, and debugging tasks.5119 npm2MIT
- AlicenseNot gradedqualityDmaintenanceEnables web search across multiple search engines (DuckDuckGo, Bing, Startpage) with parallel execution and result deduplication. Also provides web page content extraction capabilities.2MIT
- AlicenseNot gradedqualityDmaintenanceEnables web searching through Google, DuckDuckGo, and Bing using a headless Chrome browser, returning structured results with titles, URLs, and snippets. Also supports fetching and extracting text content from any webpage.16MIT
- AlicenseAqualityDmaintenanceEnables AI agents to securely read and extract information from PDF files including text content, metadata, and page counts from both local files and URLs within the project context.1MIT