什么是ClickHouse MCP 服务器？

ClickHouse MCP 服务器是一个专门设计用于AI助手的安全接口，允许它们通过受控方式访问ClickHouse数据库。它可以列出表、读取数据并执行SQL查询，从而实现对数据库的高效探索和分析。

如何使用ClickHouse MCP 服务器？

您需要先安装并配置ClickHouse MCP服务器，然后在客户端上设置相应的连接参数。之后，您可以向AI助手发送自然语言问题，它会自动转换为SQL查询并在数据库中执行。

适用场景

适用于希望利用AI助手进行数据分析的企业环境，尤其是需要快速生成洞察报告或优化业务流程的情况。

主要功能

列出数据库中的表支持通过MCP协议获取数据库内所有可用表的列表。

执行SQL查询允许用户提交SQL语句并在ClickHouse中运行，返回结构化结果。

安全性增强提供严格的权限控制机制，确保AI助手仅能访问授权的数据。

优势与局限性

优势

简化AI助手与数据库交互的过程。

支持复杂的SQL查询以满足高级分析需求。

内置安全措施防止未授权访问。

局限性

可能需要额外配置才能适配特定业务场景。

依赖于ClickHouse数据库的正常运行状态。

如何使用

安装ClickHouse MCP 服务器

按照官方文档下载并安装ClickHouse MCP服务器。

配置环境变量

设置必要的数据库连接参数，如主机地址、端口及用户名密码。

启动服务器

运行服务器命令以监听MCP请求。

使用案例

查询销售区域的总销售额AI助手接收到用户的问题后，将其转换为SQL查询并返回结果。

查找最受欢迎的产品根据历史销售数据确定最畅销的产品。

常见问题

如何确保ClickHouse MCP服务器的安全性？

是否支持自定义SQL查询？

如果遇到连接失败怎么办？

🚀 ClickHouse MCP 服务器

ClickHouse MCP 服务器是为 ClickHouse 实现的一个模型上下文协议 (MCP) 服务器，它为 AI 助手提供了安全且结构化的数据库探索和分析方式。通过受控接口，AI 助手可以列出表格、读取数据并执行 SQL 查询，确保了负责任的数据库访问。

🚀 快速开始

配置

你可以通过设置环境变量或使用命令行参数来配置服务器。

环境变量配置

设置以下环境变量：

CLICKHOUSE_HOST=localhost    
CLICKHOUSE_PORT=8123         
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=CHANGE_TO_YOUR_PASSWORD
CLICKHOUSE_DATABASE=default

命令行参数配置

使用以下命令行参数：

--host：数据库主机
--port：数据库端口
--user：数据库用户名
--password：数据库密码
--database：数据库名称

使用方法

假设一些 ClickHouse 中的数据

请参考 dev_contribute.md 文件中的 SQL 语句。

在 Cline 中向 AI 助手提问

What is the sales volume in each region? Which product is the best - selling?

CLINE

在 VSCode、Cline 扩展或其他 MCP 客户端中配置 MCP 服务器，示例如下：

{
  "mcpServers": {
    "clickhouse": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/clickhouse_mcp_server",
        "run",
        "-m",
        "clickhouse_mcp_server.server"
      ],
      "env": {
        "CLICKHOUSE_HOST": "localhost",
        "CLICKHOUSE_PORT": "8123",
        "CLICKHOUSE_USER": "default",
        "CLICKHOUSE_PASSWORD": "CHANGE_TO_YOUR_PASSWORD",
        "CLICKHOUSE_DATABASE": "default"
      }
    }
    
  }
}