Skip to main content

An MCP server for Hydrolix.

Project description

Hydrolix MCP Server

PyPI - Version

An MCP server for Hydrolix.

Tools

  • run_select_query

    • Execute SQL queries on your Hydrolix cluster.
    • Input: sql (string): The SQL query to execute.
    • All Hydrolix queries are run with readonly = 1 to ensure they are safe.
  • list_databases

    • List all databases on your Hydrolix cluster.
  • list_tables

    • List all tables in a database.
    • Input: database (string): The name of the database.

Effective Usage

Due to the wide variety in LLM architectures, not all models will proactively use the tools above, and few will use them effectively without guidance, even with the carefully-constructed tool descriptions provided to the model. To get the best results out of your model while using the Hydrolix MCP server, we recommend the following:

  • Refer to your Hydrolix database by name and request tool usage in your prompts (e.g., "Using MCP tools to access my Hydrolix database, please ...")
    • This encourages the model to use the MCP tools available and minimizes hallucinations.
  • Include time ranges in your prompts (e.g., "Between December 5 2023 and January 18 2024, ...") and specifically request that the output be ordered by timestamp.

Configuration

The Hydrolix MCP server is configured using a standard MCP server entry. Consult your client's documentation for specific instructions on where to find or declare MCP servers. An example setup using Claude Desktop is documented below.

The recommended way to launch the Hydrolix MCP server is via the uv project manager, which will manage installing all other dependencies in an isolated environment.

MCP Server definition (JSON):

{
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp-hydrolix",
    "--python",
    "3.13",
    "mcp-hydrolix"
  ],
  "env": {
    "HYDROLIX_HOST": "<hydrolix-host>",
    "HYDROLIX_USER": "<hydrolix-user>",
    "HYDROLIX_PASSWORD": "<hydrolix-password>",
  }
}

MCP Server definition (YAML):

command: uv
args:
- run
- --with
- mcp-hydrolix
- --python
- "3.13"
- mcp-hydrolix
env:
  HYDROLIX_HOST: <hydrolix-host>
  HYDROLIX_USER: <hydrolix-user>
  HYDROLIX_PASSWORD: <hydrolix-password>

Configuration Example (Claude Desktop)

  1. Open the Claude Desktop configuration file located at:

    • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • On Windows: %APPDATA%/Claude/claude_desktop_config.json
  2. Add a mcp-hydrolix server entry to the mcpServers config block:

{
  "mcpServers": {
    "mcp-hydrolix": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-hydrolix",
        "--python",
        "3.13",
        "mcp-hydrolix"
      ],
      "env": {
        "HYDROLIX_HOST": "<hydrolix-host>",
        "HYDROLIX_USER": "<hydrolix-user>",
        "HYDROLIX_PASSWORD": "<hydrolix-password>",
      }
    }
  }
}
  1. Update the environment variable definitions to point to your Hydrolix cluster.

  2. (Recommended) Locate the command entry for uv and replace it with the absolute path to the uv executable. This ensures that the correct version of uv is used when starting the server. You can find this path using which uv or where.exe uv.

  3. Restart Claude Desktop to apply the changes. If you are using Windows, ensure Claude is stopped completely by closing the client using the system tray icon.

Environment Variables

The following variables are used to configure the Hydrolix connection. These variables may be provided via the MCP config block (as shown above), a .env file, or traditional environment variables.

Required Variables

  • HYDROLIX_HOST: The hostname of your Hydrolix server
  • HYDROLIX_USER: The username for authentication
  • HYDROLIX_PASSWORD: The password for authentication

Optional Variables

  • HYDROLIX_PORT: The port number of your Hydrolix server
    • Default: 8088
    • Usually doesn't need to be set unless using a non-standard port
  • HYDROLIX_VERIFY: Enable/disable SSL certificate verification
    • Default: "true"
    • Set to "false" to disable certificate verification (not recommended for production)
  • HYDROLIX_DATABASE: Default database to use
    • Default: None (uses server default)
    • Set this to automatically connect to a specific database

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_hydrolix-0.1.1.tar.gz (31.2 kB view details)

Uploaded Source

Built Distribution

mcp_hydrolix-0.1.1-py3-none-any.whl (12.8 kB view details)

Uploaded Python 3

File details

Details for the file mcp_hydrolix-0.1.1.tar.gz.

File metadata

  • Download URL: mcp_hydrolix-0.1.1.tar.gz
  • Upload date:
  • Size: 31.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for mcp_hydrolix-0.1.1.tar.gz
Algorithm Hash digest
SHA256 c253931a587a5c66f40c4b4e41bb4d64a4bf45ad44c1c8126fdf69d5becf3cbb
MD5 c7a7f30c2d8d230b3d0ae4b5c70e3621
BLAKE2b-256 8325862ed3a307843ed5c3c6c66c08bca4acf20107b8510e3431d1a8b9e777ab

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_hydrolix-0.1.1.tar.gz:

Publisher: publish.yml on hydrolix/mcp-hydrolix

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mcp_hydrolix-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: mcp_hydrolix-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 12.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for mcp_hydrolix-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 871949c5cd3660e5c716b01c69c6ea0e67c64dfae4c3c64b528d90eb391332d0
MD5 cb1c66ceff6165807ea7a3b50edf6200
BLAKE2b-256 7947afebeb3200a97d799fb7725f2befa9aef77d11efa25daf1ceb6330592519

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_hydrolix-0.1.1-py3-none-any.whl:

Publisher: publish.yml on hydrolix/mcp-hydrolix

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page