JinDaGe - mcp-hydrolix MCP Details

article

README

🚀 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_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 服务器，并充分利用其提供的功能来管理和查询您的数据。

mcp-hydrolix