MCP Hydrolix

🚀 Hydrolix MCP 服務器

一個用於 Hydrolix 的 MCP 服務器，可幫助用戶在 Hydrolix 集群上執行 SQL 查詢、列出數據庫和表等操作。

✨ 主要特性

工具列表

• run_select_query
  • 功能：在您的 Hydrolix 集群上執行 SQL 查詢。
  • 輸入：sql（字符串），即要執行的 SQL 查詢。
  • 安全保障：所有 Hydrolix 查詢均以 readonly = 1 運行，確保查詢安全。
• list_databases
  • 功能：列出您的 Hydrolix 集群上的所有數據庫。
• list_tables
  • 功能：列出某個數據庫中的所有表。
  • 輸入：database（字符串），即數據庫名稱。

💡 使用建議

⚠️ 重要提示

由於各種 LLM 架構的差異，不是所有的模型都會主動使用這些工具，更不用說高效地使用它們了。即使有精心構建的工具描述提供給模型，也很少會使用得當。

💡 使用建議

• 使用您的 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 MCP 服務器，並充分利用其提供的功能來管理和查詢您的數據。