mcp-羟基利克斯

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）：

{
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp-hydrolix",
    "--python",
    "3.13",
    "mcp-hydrolix"
  ],
  "env": {
    "HYDROLIX_HOST": "<hydrolix-host>",
    "HYDROLIX_USER": "<hydrolix-user>",
    "HYDROLIX_PASSWORD": "<hydrolix-password>"
  }
}

MCP 服务器定义（YAML）：

command: uv
args:
- run
- --with
- mcp-hydrolix
- --python
- "3.13"
- mcp-hydrolix
env:
  HYDROLIX_HOST: <hydrolix-host>
  HYDROLIX_USER: <hydrolix-user>
  HYDROLIX_PASSWORD: <hydrolix-password>

配置示例（Claude 桌面）

打开位于以下位置的 Claude Desktop 配置文件：
- 在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json
- 在 Windows 上： %APPDATA%/Claude/claude_desktop_config.json
将mcp-hydrolix服务器条目添加到mcpServers配置块：

{
  "mcpServers": {
    "mcp-hydrolix": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-hydrolix",
        "--python",
        "3.13",
        "mcp-hydrolix"
      ],
      "env": {
        "HYDROLIX_HOST": "<hydrolix-host>",
        "HYDROLIX_USER": "<hydrolix-user>",
        "HYDROLIX_PASSWORD": "<hydrolix-password>"
      }
    }
  }
}

更新环境变量定义以指向您的 Hydrolix 集群。
（推荐）找到uv的命令条目，并将其替换为uv可执行文件的绝对路径。这可确保启动服务器时使用正确版本的uv 。您可以使用which uv或where.exe uv找到此路径。
重启 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 ：默认使用的数据库
- 默认值：无（使用服务器默认值）
- 将其设置为自动连接到特定数据库