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