Free MCP Web Search Server

Zero API Keys Required - Completely Free Forever

v1.0.0

🔍

Web Search

📄

Content Extraction

Parse any webpage

⚡

Fast & Cached

5-minute result cache

🔗

MCP Protocol

Claude Desktop Ready

📡 REST API Endpoints

🔍 Web Search

GET /api/search?query=term&num_results=10

{
  "query": "python tutorial",
  "count": 10,
  "results": [{ "title": "...", "url": "...", "snippet": "...", "domain": "..." }]
}

📄 Extract Content

GET /api/extract?url=https://...

{
  "url": "https://example.com",
  "title": "Example",
  "content": "Page text...",
  "links": [],
  "images": []
}

📦 Batch Search

POST /api/batch

Body: {"queries": ["AI", "ML"], "num_results": 5}

💚 Health Check

GET /api/health

{"status": "healthy", "service": "FreeMCP Search Server", "version": "1.0.0"}

🔧 MCP Server Configuration

Add this to your Claude Desktop MCP configuration file:

{
  "mcpServers": {
    "free-web-search": {
      "command": "python",
      "args": ["/path/to/mcp_server.py", "--mcp"],
      "env": {}
    }
  }
}

docker run -p 8080:8080 free-mcp-search

# Install dependencies
pip install -r requirements.txt

# Run MCP server
python mcp_server.py --mcp

# Or run REST API only
python mcp_server.py

🛠️ MCP Tools Available

🔍 web_search

Search the web for information

Arguments: {"query": "search term", "num_results": 10}

📄 get_page_content

Extract content from a webpage

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

📦 batch_search

Perform multiple searches at once

Arguments: {"queries": ["AI news", "ML tips"], "num_results": 5}

📰 search_news

Search for recent news

Arguments: {"query": "technology", "num_results": 10}

🚀 Quick Start

1️⃣ Clone & Install

# Clone the project
git clone <repository-url>
cd free-mcp-search-server

# Install dependencies
pip install -r requirements.txt

# Or with Docker
docker build -t free-mcp-search .
docker run -p 8080:8080 free-mcp-search

2️⃣ Run the Server

# REST API mode (default)
python mcp_server.py

# MCP mode (for Claude Desktop)
python mcp_server.py --mcp