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 桌面）

1. 打开位于以下位置的 Claude Desktop 配置文件：

   • 在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json

   • 在 Windows 上： %APPDATA%/Claude/claude_desktop_config.json

2. 将mcp-hydrolix服务器条目添加到mcpServers配置块：

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 ：默认使用的数据库

  • 默认值：无（使用服务器默认值）

  • 将其设置为自动连接到特定数据库