Skip to content

Home

Jump to bottom
Syed Asif edited this page Jun 14, 2026 · 13 revisions

web-search-mcp

web-search-mcp is a FastMCP server providing web search, content extraction, and research tools for LLM clients. It implements the Model Context Protocol (MCP) to give LLMs access to real-time web information across multiple free data sources.

Quick Start

Prerequisites

  • Python 3.11+
  • uv for dependency management

Installation

git clone https://github.com/sydasif/web-search-mcp.git
cd web-search-mcp
uv sync

Running the Server

uv run web-search-mcp

Or via uvx without cloning (configure in your MCP client):

{
  "mcpServers": {
    "web-search-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/sydasif/web-search-mcp.git",
        "web-search-mcp"
      ]
    }
  }
}

Permanent Install (Faster Startup)

uv tool install git+https://github.com/sydasif/web-search-mcp.git
uv tool upgrade web-search-mcp  # update later

Claude Code Plugin

Install the plugin (skills + MCP tools) directly from this repo:

/plugin marketplace add sydasif/web-search-mcp
/plugin install web-search@sydasif-web-search-mcp
/reload-plugins

Once installed, use via namespaced commands:

  • /web-search:deep-research — multi-source web research across 7 platforms
  • /web-search:debug-code — structured error debugging with external evidence

Core Capabilities

  • Web Search: Fast, raw search results via DuckDuckGo, plus domain-scoped documentation search.
  • Content Extraction: Clean text extraction from URLs with multiple output formats.
  • Academic Research: arXiv paper search across all scientific categories.
  • Community Signal: Reddit search for real-user experiences and discussions.
  • Tech Discourse: Hacker News search for developer opinions and startup discussions.
  • Code Discussions: GitHub Issues and PRs search across repositories.
  • Real-time Discourse: X/Twitter search for breaking news and community reactions.
  • AI Research: Deep research and page analysis via Groq GPT-OSS and Compound systems.
  • Developer Tools: Package registry lookups (npm, PyPI, crates.io, Go), error message analysis, technology comparison.

Sources at a Glance

Source Tools Auth
DuckDuckGo web_search, fetch_page None
Reddit reddit_search None
Hacker News hackernews_search None
GitHub github_search, get_github_issue Optional token or gh CLI
Wikipedia wikipedia_search None
arXiv arxiv_search None
X/Twitter x_search AUTH_TOKEN + CT0
Groq groq_search, groq_analyze GROQ_API_KEY
Developer package_info, package_search, translate_error, compare_tech None

Architecture | Tools | Tools-Status | Development | Configuration | Plugin

Clone this wiki locally