mcp-search-hub

Name: mcp-search-hub
Availability: InStock
Author: Bjorn Melin

🔍 Intelligent multi-provider search aggregation server built on FastMCP 2.0

GitHub

GitHub Stars

User Rating

Not Rated

Favorites

Views

Forks

Issues

README

MCP Search Hub

🔍 Intelligent multi-provider search aggregation server built on FastMCP 2.0

MCP Search Hub embeds official MCP servers from five leading search providers within a unified interface, intelligently routes queries to the most appropriate provider(s), and combines/ranks results for optimal relevance.

✨ Key Features

🏗️ Unified Interface: Single MCP server for all search providers
🧠 Intelligent Routing: Automatically selects optimal providers based on query characteristics
⚡ Official Provider Integration: Embeds official MCP servers (Linkup, Exa, Perplexity, Tavily, Firecrawl)
💰 Cost Optimization: 30-45% cost reduction through intelligent provider selection
🚀 Zero Maintenance: Provider updates flow through automatically
📊 Smart Result Merging: Deduplication and multi-factor ranking
⚡ Performance Optimized: Multi-tier caching and parallel execution
🔧 Production Ready: Error handling, rate limiting, monitoring

🚀 Quick Start

Get up and running in 5 minutes:

# 1. Clone and install
git clone https://github.com/BjornMelin/mcp-search-hub
cd mcp-search-hub
uv pip install -r requirements.txt

# 2. Interactive setup (recommended)
python scripts/setup_claude_desktop.py

# 3. Start searching!
# The script will guide you through API key setup and Claude Desktop integration

After setup, restart Claude Desktop and ask: "What MCP tools do you have available?"

📖 Complete Setup Guide | ⚡ Quick Setup Script

🎯 Why MCP Search Hub?

Provider Strengths

Each provider excels in different areas. MCP Search Hub automatically routes queries to leverage these strengths:

Provider	Strengths	Best For	Accuracy
Linkup	Factual information, current events	News, facts, real-time data	91.0%
Exa	Semantic search, academic content	Research papers, technical docs	90.0%
Perplexity	AI-powered analysis, current events	Complex queries, analysis	86.0%
Tavily	RAG-optimized results	Retrieval applications	73.0%
Firecrawl	Deep content extraction	Web scraping, full content	N/A

Accuracy scores from SimpleQA benchmark

Architecture Benefits

graph TB
    User[Claude Desktop/Code] --> Hub[MCP Search Hub]
    Hub --> Router[Intelligent Router]
    
    Router -->|Academic Query| Exa[Exa MCP Server]
    Router -->|News Query| Perplexity[Perplexity MCP Server]
    Router -->|Factual Query| Linkup[Linkup MCP Server]
    Router -->|Scraping Task| Firecrawl[Firecrawl MCP Server]
    
    Hub --> Cache[Smart Caching]
    Hub --> Merger[Result Merger]
    
    style Hub fill:#e1f5fe
    style Router fill:#f3e5f5
    style Cache fill:#e8f5e8
    style Merger fill:#fff3e0

Benefits:

Single Integration: One MCP server instead of five
Zero Configuration: No need to manage multiple servers
Automatic Updates: Provider improvements flow through automatically
Cost Efficient: Intelligent routing reduces unnecessary API calls
Quality Results: Multi-provider consensus improves accuracy

📚 Documentation

For Users

Getting Started - Complete setup guide and first steps
Configuration - Detailed configuration reference
API Reference - Complete tool and endpoint documentation
Troubleshooting - Solutions to common problems

For Developers

Contributing - How to contribute to the project
Development - Development workflows and practices
Architecture - System design and components

Advanced Topics

Provider Integration - How providers are embedded
Caching Strategy - Multi-tier caching system
Performance Tuning - Optimization strategies

📖 Complete Documentation Index

🔑 Quick Configuration

At minimum, you need API keys for the providers you want to use:

# Copy environment template
cp .env.template .env

# Add your API keys
LINKUP_API_KEY=your_linkup_key
EXA_API_KEY=your_exa_key
PERPLEXITY_API_KEY=your_perplexity_key
TAVILY_API_KEY=your_tavily_key
FIRECRAWL_API_KEY=your_firecrawl_key

Getting API Keys

Provider	Free Tier	Sign Up
Linkup	100 requests/month	linkup.so
Exa	1,000 requests/month	exa.ai
Perplexity	$5 credit	perplexity.ai
Tavily	1,000 requests/month	tavily.com
Firecrawl	500 requests/month	firecrawl.dev

⚙️ Complete Configuration Guide

🚀 Available Tools

MCP Search Hub provides all tools from embedded provider MCP servers:

Core Search Tools

search - Intelligent multi-provider search with automatic routing
get_provider_info - Information about available providers

Provider-Specific Tools (25+ tools available)

Firecrawl: firecrawl_scrape, firecrawl_search, firecrawl_crawl, firecrawl_extract
Exa: web_search_exa, research_paper_search, company_research, linkedin_search
Perplexity: perplexity_ask, perplexity_research
Linkup: linkup_search_web
Tavily: tavily_search, tavily_extract

🛠️ Full Tool Documentation

🏗️ Architecture

MCP Search Hub uses a modular architecture with embedded MCP servers:

graph TB
    subgraph "MCP Search Hub"
        Server[FastMCP Server]
        Router[Query Router]
        Cache[Tiered Cache]
        Merger[Result Merger]
    end
    
    subgraph "Embedded MCP Servers"
        LinkupMCP[Linkup MCP]
        ExaMCP[Exa MCP]
        PerplexityMCP[Perplexity MCP]
        TavilyMCP[Tavily MCP]
        FirecrawlMCP[Firecrawl MCP]
    end
    
    Client[Claude Desktop] --> Server
    Server --> Router
    Router --> LinkupMCP
    Router --> ExaMCP
    Router --> PerplexityMCP
    Router --> TavilyMCP
    Router --> FirecrawlMCP
    
    style Server fill:#e1f5fe
    style Router fill:#f3e5f5
    style Cache fill:#e8f5e8
    style Merger fill:#fff3e0

🏗️ Architecture Documentation