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