hybrid-search-mcp

# Hybrid Search MCP Server An MCP (Model Context Protocol) server that provides read-only access to the Hybrid Search knowledge base. Enables AI assistants in Windsurf, VS Code, Open Code, and Claude Desktop to query collections and search documents using hybrid search (semantic + keyword with RRF ranking). > **⚠️ IMPORTANT PREREQUISITE** > > This MCP server requires the Hybrid Search container stack to be running in order to work. The MCP server does not directly access the database - it communicates with the Hybrid Search backend API. When you install the Hybrid Search container stack, it automatically ensures that the backend API is available at `http://localhost:8000`. ## Features - **List Collections**: View all available knowledge base collections - **Get Collection Details**: See document counts, chunk counts, and metadata - **List Files**: View all files in a collection with chunk counts - **Hybrid Search**: Search using semantic AI + keyword matching with Reciprocal Rank Fusion ## Prerequisites - Python 3.11+ - [uv](https://docs.astral.sh/uv/) package manager (recommended) - Hybrid Search backend running at `http://localhost:8000` ## Installation ### From PyPI (Recommended) Once published to PyPI, you can install with: ```bash # Using pip pip install hybrid-search-mcp # Using uvx (run without installing) uvx hybrid-search-mcp # Using pipx (isolated environment) pipx install hybrid-search-mcp ``` ### From Source #### Using uv (Recommended) ```bash cd mcp-server uv sync ``` #### Using pip ```bash cd mcp-server pip install -e . ``` ## Configuration The MCP server connects to the Hybrid Search FastAPI backend. Configure via environment variables: | Variable | Default | Description | |----------|---------|-------------| | `HYBRID_SEARCH_API_URL` | `http://localhost:8000` | Backend API base URL | | `HYBRID_SEARCH_API_TIMEOUT` | `30.0` | Request timeout in seconds | ## Running the Server ### If Installed via pip/uvx ```bash # Direct comma…