English Français العربية

Heventure Search MCP

مجتمعي البحث والويب

Web search across DuckDuckGo, Bing, Google (via SerpAPI) and Tavily with automatic rate limiting, caching and multi-language support.

الشيفرة المصدرية التوثيق

التثبيت

خطوات التثبيت موجودة في التوثيق أدناه. التوثيق

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. 🔍 MCP Web Search Server
  2. ✨ Why?
  3. 🚀 Quick Start
  4. 🔧 Available Tools
  5. 🔑 Optional: Enhanced Search
  6. 🏗️ Architecture
  7. 🤝 Contributing
  8. 📄 License

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

FeatureThis ServerOthers
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

Search the web with multiple engines simultaneously.

ParameterTypeDefaultDescription
querystringrequiredSearch query
max_resultsint10Number of results (1-20)
search_enginestring"both"duckduckgo, bing, google, or both
get_page_content

Extract readable text from any webpage.

ParameterTypeDefaultDescription
urlstringrequiredPage URL to fetch

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.

الأسئلة الشائعة

ما هو Heventure Search MCP؟

Web search across DuckDuckGo, Bing, Google (via SerpAPI) and Tavily with automatic rate limiting, caching and multi-language support.

كيف أثبّت Heventure Search MCP؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل Heventure Search MCP مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Heventure Search MCP؟

ينشره HughesCuit. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من القوائم المجتمعية awesome-mcp-servers ومستودع المشروع على GitHub. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.