星战科技xingzhan.cloud
返回市场
ClickHouse_MCP_服务器

ClickHouse_MCP_服务器

作者：dubin5558 星标更新：2025-03-20
安装使用来源：spider==github.com

项目介绍

ClickHouse MCP 服务器

这是一个为 ClickHouse 实现的 Model Context Protocol (MCP) 服务器。

该服务器为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 助手提问

每个地区的销售量是多少？哪种产品最畅销？
<img src="pics/demo.png" alt="演示截图" width="600" />

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"
      }
    }
    
  }
}

许可证

APACHE - 详情见 LICENSE 文件。

贡献

详情见 dev_contribute.md。

先决条件

  • 带有 uv 包管理器的 Python
  • ClickHouse 安装
  • MCP 服务器依赖项

致谢

本库的实现受到了以下三个仓库的启发，并结合了它们的代码，尊重开源精神！

感谢！