mcp-smart-searcher

# MCP Smart Searcher A smart MCP (Model Context Protocol) server for multi-engine web search with AI-powered results. ## Features - **Multi-engine search** — Search across 8 engines simultaneously: DuckDuckGo, Baidu, Juejin, GitHub, GitHub Code, Tavily, Brave, Startpage - **Web content extraction** — Fetch and extract clean content from any public URL in multiple formats: - `markdown` (default) — Structured Markdown with headings, lists, code blocks, tables, and links preserved - `article` — Reader-mode extraction via Mozilla Readability, ideal for blogs/docs/news - `text` — Plain text, legacy behavior - `outline` — Page structure overview (headings, regions, interactive elements) without full content - Plus noise removal, hidden-element stripping, and prompt-guided filtering - **Rate limiting** — Built-in concurrency control via semaphore - **Proxy support** — Per-engine proxy configuration - **Engine allowlist** — Restrict which engines can be used ## Installation ```bash # For users pip install mcp-smart-searcher # For development pip install -e ".[dev]" ``` ## Usage ### Run the server ```bash # Direct command (after pip install) mcp-smart-searcher # Or via Python module python -m mcp_smart_searcher # Or via uvx (no install required) uvx mcp-smart-searcher ``` ### MCP client configuration Add to your MCP client config (e.g., Claude Desktop): ```json { "mcpServers": { "smart-searcher": { "command": "mcp-smart-searcher" } } } ``` Or with `uvx` (no install required): ```json { "mcpServers": { "smart-searcher": { "command": "uvx", "args": ["mcp-smart-searcher"] } } } ``` ### Development ```bash # Run with MCP inspector mcp dev src/mcp_smart_searcher/server.py # Run tests PYTHONPATH=src pytest # Build python -m build ``` ## Configuration All settings are configured via environment variables: | Variable | Description | Default | |---|---|---| | `DEFAULT_SEARCH_ENGINES` | Comma-separated default…