MCP Hydrolix

0.2.6 verified Fri May 01 auth: no python

An MCP (Model Context Protocol) server for Hydrolix, providing a bridge between AI agents and Hydrolix databases. Version 0.2.6 is the latest as of May 2026. The library is under active development, but with a small user base.

pip install mcp-hydrolix

Common errors

error ModuleNotFoundError: No module named 'mcp_hydrolix' ↓

cause Running Python <3.13 or missing pip install.

fix

Ensure Python 3.13+ is active and run 'pip install mcp-hydrolix'.

error ImportError: cannot import name 'HydrolixMCPServer' from 'mcp_hydrolix' ↓

cause Using a version older than 0.2.0, where the class was named 'HydrolixMCP'.

fix

Upgrade to 0.2.6 with 'pip install --upgrade mcp-hydrolix' and use 'HydrolixMCPServer'.

Warnings

gotcha The library requires Python >=3.13. Using it with older Python versions will fail with a syntax error. ↓

fix Upgrade to Python 3.13 or later.

gotcha The HydrolixMCPServer constructor expects parameters 'hydrolix_endpoint' and 'hydrolix_token', but the parameter names might change in future versions (pre-1.0). ↓

fix Refer to the official README for the exact parameter names.

breaking The import path changed between 0.1.x and 0.2.x: previously 'from hydrolix_mcp import ...', now 'from mcp_hydrolix import ...'. ↓

fix Update imports to use 'mcp_hydrolix'.

Imports

HydrolixMCPServer

wrong

from mcp_hydrolix.server import HydrolixMCPServer

correct

from mcp_hydrolix import HydrolixMCPServer

The correct import is at the top level, not from a submodule.

Quickstart

Create an MCP server pointing at a Hydrolix instance. Authentication is via endpoint URL and token.

import os
from mcp_hydrolix import HydrolixMCPServer

server = HydrolixMCPServer(
    hydrolix_endpoint=os.environ.get('HYDROLIX_ENDPOINT', ''),
    hydrolix_token=os.environ.get('HYDROLIX_TOKEN', '')
)
# Run the server (blocks)
server.run()