ClickHouse MCP服务器

该项目实现了一个ClickHouse的模型上下文协议(MCP)服务器,用于无缝集成ClickHouse数据库与大型语言模型(LLMs)和其他AI应用。

  • by ThomAub
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 ThomAub/clickhouse_mcp_server

使用说明

ClickHouse MCP服务器

该项目为ClickHouse实现了一个模型上下文协议(MCP)服务器,允许ClickHouse数据库与大型语言模型(LLM)和其他人工智能应用程序无缝集成。

特性

  • 将ClickHouse数据库和表列为资源
  • 检索表架构
  • 在ClickHouse数据库上执行SELECT查询
  • 使用MCP协议进行安全高效的通信

需求

  • Python 3.10+
  • ClickHouse服务器

安装

  1. 克隆存储库:

    git clone https://github.com/ThomAub/clickhouse_mcp_server.git
    cd clickhouse_mcp_server
    
  2. 安装所需的软件包:

    uv sync --all-extras
    
  3. 在环境变量中设置ClickHouse连接详细信息或更新 get_clickhouse_client 功能在 server.py.

用法

运行服务器:

python clickhouse_mcp_server/server.py

服务器将启动并监听MCP请求。

测试

使用pytest运行测试:

pytest tests/

贡献

欢迎投稿!请随时提交拉取请求。

许可证

该项目根据MIT许可证获得许可。