MCP Hydrolix

🚀 Hydrolix MCP サーバー

Hydrolix 用の MCP サーバーです。

✨ 主な機能

ツール

• run_select_query

  • Hydrolix クラスタ上で SQL クエリを実行します。
  • 入力: sql（文字列）：実行する SQL クエリ。
  • すべての Hydrolix クエリは readonly = 1 で実行され、安全性が確保されます。

• list_databases

  • Hydrolix クラスタ上のすべてのデータベースをリストします。

• list_tables

  • 特定のデータベース内のすべてのテーブルをリストします。
  • 入力: database（文字列）：データベース名。

実効使用アドバイス

様々な LLM アーキテクチャの違いにより、すべてのモデルがこれらのツールを能動的に使用するわけではありません。たとえモデルに精巧に構築されたツールの説明が提供されていても、適切に使用されることは少ないです。Hydrolix MCP サーバーを使用する際に最適な結果を得るために、以下の方法をおすすめします。

• Hydrolix データベース名を使用し、プロンプト内でツールの使用を要求します（例：「MCP ツールを使用して私の Hydrolix データベースにアクセスしてください...」）
  • これにより、モデルが利用可能な MCP ツールを使用するように促され、幻覚を最小限に抑えます。
• プロンプト内に時間範囲を含め（例：「2023 年 12 月 5 日から 2024 年 1 月 18 日までの間で...」）、タイムスタンプでの出力のソートを明示的に要求します。
  • これにより、モデルが 主キー最適化 を利用したより効率的なクエリを作成するように促されます。

📦 インストール

設定

Hydrolix MCP サーバーは標準的な MCP サーバーエントリで設定されます。具体的な場所と MCP サーバーの宣言方法については、クライアントのドキュメントを参照してください。以下に、Claude Desktop を使用した設定例を示します。

uv プロジェクトマネージャーを使用して Hydrolix MCP サーバーを起動することをおすすめします。これにより、すべての依存関係が隔離された環境で自動的にインストールされます。

設定例（JSON）

{
  "id": "hydrolix-mcp-server",
  "name": "Hydrolix MCP Server",
  "type": "module",
  "config": {
    "host": "localhost",
    "port": 8088,
    "ssl": true,
    "verify_ssl": true,
    "databases": [
      {
        "name": "default_db",
        "user": "admin",
        "password": "secure_password"
      }
    ]
  },
  "variables": {},
  "functions": {
    "run_select_query": {
      "type": "function",
      "description": "SELECT クエリを実行し、結果を返します。",
      "parameters": [
        {
          "name": "sql",
          "type": "string",
          "description": "実行する SQL クエリ。"
        }
      ],
      "returns": {
        "type": "array",
        "description": "クエリの結果セット。各要素は辞書です。"
      }
    },
    "list_databases": {
      "type": "function",
      "description": "すべての利用可能なデータベースをリストします。",
      "parameters": [],
      "returns": {
        "type": "array",
        "description": "データベース名のリスト。"
      }
    },
    "list_tables": {
      "type": "function",
      "description": "指定されたデータベース内のすべてのテーブルをリストします。",
      "parameters": [
        {
          "name": "database",
          "type": "string",
          "description": "テーブルをリストするデータベース名。"
        }
      ],
      "returns": {
        "type": "array",
        "description": "テーブル名のリスト。"
      }
    }
  }
}

設定例（YAML）

id: hydrolix-mcp-server
name: Hydrolix MCP Server
type: module
config:
  host: localhost
  port: 8088
  ssl: true
  verify_ssl: true
  databases:
    - name: default_db
      user: admin
      password: secure_password
variables: {}
functions:
  run_select_query:
    type: function
    description: SELECT クエリを実行し、結果を返します。
    parameters:
      - name: sql
        type: string
        description: 実行する SQL クエリ。
    returns:
      type: array
      description: クエリの結果セット。各要素は辞書です。
  list_databases:
    type: function
    description: すべての利用可能なデータベースをリストします。
    parameters: []
    returns:
      type: array
      description: データベース名のリスト。
  list_tables:
    type: function
    description: 指定されたデータベース内のすべてのテーブルをリストします。
    parameters:
      - name: database
        type: string
        description: テーブルをリストするデータベース名。
    returns:
      type: array
      description: テーブル名のリスト。

環境変数設定

必須変数

• HYDROLIX_HOST または host

  • デフォルト: localhost
  • Hydrolix サーバーのホストアドレスを設定します。

• HYDROLIX_PORT または port

  • デフォルト: 8088
  • Hydrolix サーバーのポート番号を設定します。

• HYDROLIX_USER または user

  • 必須
  • Hydrolix データベースにログインするための認証ユーザー名。

• HYDROLIX_PASSWORD または password

  • 必須
  • 認証に使用するユーザーのパスワード。

オプション変数

• HYDROLIX_VERIFY_SSL または verify_ssl

  • デフォルト: true
  • false に設定すると、SSL 証明書の検証を無効にできます（本番環境では推奨されません）。

• HYDROLIX_DATABASE または database

  • デフォルト: なし
  • この値を設定すると、デフォルトのデータベースではなく、特定のデータベースに自動的に接続できます。

以上の設定と環境変数の設定により、Hydrolix MCP サーバーを正常に設定して実行し、提供される機能を活用してデータを管理およびクエリすることができます。