mcp-ferris-search

# MCP Ferris Search A blazing-fast MCP (Model Context Protocol) server for multi-engine web search, written in Python. This is a Python implementation inspired by the original [ferris-search](https://github.com/lispking/ferris-search) Rust project. ## Features - **Multi-engine fan-out** — search across multiple engines simultaneously with a single call - **9 search engines** — Bing, DuckDuckGo, Brave, Baidu, CSDN, Juejin, Zhihu, GitHub, GitHub Code - **7 MCP tools** — `web_search` + 6 content fetchers - **No API keys required** for most engines (Brave requires API key) - **Proxy support** — HTTP/SOCKS5 proxy via environment variables ## Installation ### From PyPI (recommended) ```bash pip install mcp-ferris-search ``` ### Using uvx ```bash uvx mcp-ferris-search ``` ### From source ```bash git clone https://github.com/your-username/mcp-ferris-search.git cd mcp-ferris-search pip install -e . ``` ## Configuration ### Claude Desktop / Cursor Add to your MCP settings: ```json { "mcpServers": { "ferris-search": { "command": "uvx", "args": ["mcp-ferris-search"], "env": { "DEFAULT_SEARCH_ENGINE": "bing" } } } } ``` ### Environment Variables | Variable | Default | Description | |----------|---------|-------------| | `DEFAULT_SEARCH_ENGINE` | `bing` | Default engine when `engines` param is omitted | | `ALLOWED_SEARCH_ENGINES` | all engines | Comma-separated allow-list | | `BRAVE_API_KEY` | — | Required for Brave search | | `GITHUB_TOKEN` | — | Optional, raises GitHub API rate limit | | `USE_PROXY` | `false` | Enable HTTP/SOCKS5 proxy | | `PROXY_URL` | `http://127.0.0.1:7890` | Proxy address | ## MCP Tools ### `web_search` Search the web using one or more engines simultaneously. ```json { "query": "rust async runtime", "engines": ["bing", "duckduckgo"], "limit": 10 } ``` | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `query` | string | required | Search query |…