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を使用した設定例を以下に示します。

Hydrolix MCP サーバーを起動するには、 uvを使用することをお勧めします。これにより、分離された環境で他のすべての依存関係のインストールが管理されます。

MCP サーバー定義 (JSON):

MCP サーバー定義 (YAML):

設定例（Claude Desktop）

1. 次の場所にある Claude Desktop 構成ファイルを開きます。

   • macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

2. mcpServers構成ブロックにmcp-hydrolixサーバー エントリを追加します。

3. Hydrolix クラスターを指すように環境変数定義を更新します。

4. (推奨) uvのコマンドエントリを見つけ、 uv実行ファイルへの絶対パスに置き換えてください。これにより、サーバーの起動時に正しいバージョンのuvが使用されるようになります。このパスはwhich uvまたはwhere.exe uvで確認できます。

5. 変更を適用するには、Claude Desktop を再起動してください。Windows をご利用の場合は、システムトレイアイコンを使用してクライアントを閉じ、Claude が完全に停止していることを確認してください。

環境変数

Hydrolix接続の設定には、以下の変数が使用されます。これらの変数は、MCP設定ブロック（上記参照）、. .envファイル、または従来の環境変数を介して指定できます。

必須変数

• HYDROLIX_HOST : Hydrolixサーバーのホスト名

• HYDROLIX_USER : 認証用のユーザー名

• HYDROLIX_PASSWORD : 認証用のパスワード

オプション変数

• HYDROLIX_PORT : Hydrolixサーバーのポート番号

  • デフォルト: 8088

  • 非標準ポートを使用しない限り、通常は設定する必要はありません

• HYDROLIX_VERIFY : SSL証明書検証を有効/無効にする

  • デフォルト: "true"

  • 証明書の検証を無効にするには"false"に設定します（本番環境では推奨されません）

• HYDROLIX_DATABASE : 使用するデフォルトのデータベース

  • デフォルト: なし (サーバーのデフォルトを使用)

  • 特定のデータベースに自動的に接続するにはこれを設定します