Hydrolix MCP Server

Name: Hydrolix MCP Server
Author: hydrolix

@hydrolix

リポジトリ

Hydrolix MCP Server について

An MCP server for Hydrolix

基本情報

カテゴリ

その他

ライセンス

Apache-2.0

ランタイム

python

トランスポート

stdio

公開者

hydrolix

投稿者

Ethan Bell

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "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>"
      }
    }
  }
}

ツール

Execute SQL queries on your Hydrolix cluster.

List all databases on your Hydrolix cluster.

List all tables in a database.

Get table metadata such as schema

概要

What is Hydrolix MCP Server?

Hydrolix MCP Server is an MCP server that provides tools to query and explore Hydrolix clusters. It allows AI assistants like Claude Desktop and Claude Code to execute SQL queries, list databases, list tables, and retrieve table metadata from a Hydrolix data platform.

How to use Hydrolix MCP Server?

Install with uvx (recommended) or pip; requires Python 3.13+. Configure the server in your MCP client by providing HYDROLIX_URL plus either a username/password pair (HYDROLIX_USER and HYDROLIX_PASSWORD) or a service account token (HYDROLIX_TOKEN). After restarting the client, test with a prompt like "Using your Hydrolix MCP tools, list the available databases."

Key features of Hydrolix MCP Server

Execute SQL queries via run_select_query tool
List databases and tables on a Hydrolix cluster
Retrieve table schema with get_table_info
Supports multiple authentication methods (token or username/password)
Health check endpoint at /health (HTTP/SSE transport)

Use cases of Hydrolix MCP Server

Ask an AI assistant to list databases and explore table schemas
Run ad‑hoc SQL queries on Hydrolix without a separate query tool
Let AI generate and execute time‑range‑optimized queries against Hydrolix

FAQ from Hydrolix MCP Server

What tools does the Hydrolix MCP Server provide?

It provides run_select_query for SQL queries, list_databases to list databases, list_tables to list tables in a database, and get_table_info to retrieve table metadata.

How do I authenticate to Hydrolix?

The server supports per‑request bearer tokens, per‑request query‑parameter tokens, and environment‑based credentials (HYDROLIX_USER/HYDROLIX_PASSWORD or HYDROLIX_TOKEN). Authentication methods are tried in precedence order.

What are the runtime requirements?

Python 3.13 or later. The recommended launcher is uvx (via Astral’s uv), which manages dependencies automatically.

Can I use a health check?

Yes. When using HTTP or SSE transport, a health endpoint at /health returns 200 OK with the Hydrolix query‑head ClickHouse version, or 503 if the connection fails.

Where does my data live?

Data stays on your Hydrolix cluster; the MCP server only sends queries and receives results through the Hydrolix API.

「その他」の他のコンテンツ

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K