ClickHouse MCP Server 官方镜像

镜像概述和主要用途

MCP（模型上下文协议，Model Context Protocol）服务器是一种用于简化AI应用与外部工具集成的组件，通过安全隔离的方式实现AI模型与外部服务的交互。ClickHouse MCP Server 官方镜像是由ClickHouse提供的MCP Server实现，旨在安全地让AI应用通过MCP协议访问ClickHouse数据库，执行数据库查询和管理操作。

核心功能和特性

• 数据库列表查询：提供list_databases工具，用于列出ClickHouse中可用的数据库。
• 表详情查询：提供list_tables工具，用于列出指定数据库中的表，包含表结构（schema）、注释、行数和列数等详细信息。
• SELECT查询执行：提供run_select_query工具，用于在ClickHouse数据库中执行SELECT查询语句。

使用场景和适用范围

适用于需要将ClickHouse数据库与AI应用（如Anthropic Claude）集成的场景，尤其适合需要安全访问数据库的AI应用开发。通过MCP Server，可避免直接向AI模型暴露数据库凭证，通过Docker容器隔离运行，提升数据访问的安全性。典型使用场景包括：AI辅助数据分析、自动化报表生成、基于ClickHouse数据的AI决策支持系统等。

MCP 信息

镜像构建信息

可用工具

工具详情

list_databases

功能：列出ClickHouse中可用的数据库。

list_tables

功能：列出指定数据库中的ClickHouse表，包括表结构（schema）、注释、行数和列数。

run_select_query

功能：在ClickHouse数据库中执行SELECT查询。

使用方法和配置说明

Docker 运行配置示例

以下是通过Docker运行ClickHouse MCP Server的配置示例，通常用于AI应用的MCP服务器配置中：

{
  "mcpServers": {
    "clickhouse": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CLICKHOUSE_HOST",
        "-e",
        "CLICKHOUSE_PORT",
        "-e",
        "CLICKHOUSE_USER",
        "-e",
        "CLICKHOUSE_SECURE",
        "-e",
        "CLICKHOUSE_VERIFY",
        "-e",
        "CLICKHOUSE_CONNECT_TIMEOUT",
        "-e",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT",
        "-e",
        "CLICKHOUSE_PASSWORD",
        "mcp/clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
        "CLICKHOUSE_PORT": "8443",
        "CLICKHOUSE_USER": "demo",
        "CLICKHOUSE_SECURE": "true",
        "CLICKHOUSE_VERIFY": "true",
        "CLICKHOUSE_CONNECT_TIMEOUT": "30",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30",
        "CLICKHOUSE_PASSWORD": "<YOUR_CLICKHOUSE_PASSWORD_HERE>"
      }
    }
  }
}

环境变量说明

为什么使用 Docker 运行 MCP Servers 更安全

Docker容器提供了隔离的运行环境，能够有效限制MCP Server的资源访问范围，避免直接向AI模型暴露数据库凭证。通过容器化运行，可以确保MCP Server与主机系统及其他应用隔离，降低潜在的安全风险。详情可参考Docker官方博客文章。