Skip to main content
Glama
Heventure Search MCP

Heventure Search MCP

by HughesCuit

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

uvx

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 tools
get_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).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.6/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    Both tool names follow a consistent verb_noun pattern: 'web_search' and 'get_webpage_content'. The naming is clear, predictable, and uses underscores consistently.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables browser automation using Puppeteer through the MCP interface. Allows launching browsers, creating pages, and executing arbitrary JavaScript for web scraping, testing, and debugging tasks.
      5
      119 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables web search across multiple search engines (DuckDuckGo, Bing, Startpage) with parallel execution and result deduplication. Also provides web page content extraction capabilities.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      16
      MIT