跳转到主内容
跳转到主内容

在 LibreChat 中使用 ClickHouse MCP 服务器

本指南介绍如何使用 Docker 设置 LibreChat 与 ClickHouse MCP 服务器， 并将其连接到 ClickHouse 示例数据集。

安装 Docker​

您需要 Docker 来运行 LibreChat 和 MCP 服务器。获取 Docker 的方法：

  1. 访问 docker.com
  2. 下载适用于您操作系统的 Docker Desktop
  3. 请根据您所使用的操作系统的说明安装 Docker
  4. 打开 Docker Desktop，并确保其正在运行。

有关更多信息,请参阅 Docker 文档。

克隆 LibreChat 仓库​

打开终端(命令提示符、终端或 PowerShell),并使用以下命令克隆 LibreChat 仓库:

git clone https://github.com/danny-avila/LibreChat.git
cd LibreChat

创建并编辑 .env 文件​

将示例配置文件从 .env.example 复制到 .env：

cp .env.example .env

使用您喜欢的文本编辑器打开 .env 文件。您将看到许多流行的 LLM 提供商的配置部分，例如 OpenAI、Anthropic、AWS Bedrock 等：

#============#
# Anthropic  #
#============#
#highlight-next-line
ANTHROPIC_API_KEY=user_provided
# ANTHROPIC_MODELS=claude-opus-4-20250514,claude-sonnet-4-20250514,claude-3-7-sonnet-20250219,claude-3-5-sonnet-20241022,claude-3-5-haiku-20241022,claude-3-opus-20240229,claude-3-sonnet-20240229,claude-3-haiku-20240307
# ANTHROPIC_REVERSE_PROXY=

将 user_provided 替换为您要使用的 LLM 提供商的 API 密钥。

使用本地 LLM

如果您没有 API 密钥,可以使用像 Ollama 这样的本地 LLM。您将在后续的 "安装 Ollama" 步骤中了解如何操作。现在 请不要修改 .env 文件,继续执行后续步骤。

创建 librechat.yaml 文件​

运行以下命令创建一个新的 librechat.yaml 文件：

cp librechat.example.yaml librechat.yaml

这将为 LibreChat 创建主配置文件。

将 ClickHouse MCP 服务器添加到 Docker Compose​

接下来,我们将把 ClickHouse MCP 服务器添加到 LibreChat 的 Docker Compose 文件中, 以便 LLM 能够与 ClickHouse SQL playground 交互。

创建一个名为 docker-compose.override.yml 的文件,并将以下配置添加到其中:

services:
  api:
    volumes:
      - ./librechat.yaml:/app/librechat.yaml
  mcp-clickhouse:
    image: mcp/clickhouse
    container_name: mcp-clickhouse
    ports:
      - 8001:8000
    extra_hosts:
      - "host.docker.internal:host-gateway"
    environment:
      - CLICKHOUSE_HOST=sql-clickhouse.clickhouse.com
      - CLICKHOUSE_USER=demo
      - CLICKHOUSE_PASSWORD=
      - CLICKHOUSE_MCP_SERVER_TRANSPORT=sse
      - CLICKHOUSE_MCP_BIND_HOST=0.0.0.0

如果您想探索自己的数据，您可以使用自己 ClickHouse Cloud 服务的 主机地址、用户名和密码 进行连接。

开始使用 ClickHouse Cloud
如果您还没有 Cloud 账号，现在就开始使用 ClickHouse Cloud， 即可获得价值 300 美元的赠送额度。在 30 天免费试用结束后，您可以继续采用 按需付费计划，或联系我们进一步了解基于用量的折扣信息。 详情请访问我们的定价页面。

在 librechat.yaml 中配置 MCP 服务器​

打开 librechat.yaml 文件,并将以下配置添加到文件末尾:

mcpServers:
  clickhouse-playground:
    type: sse
    url: http://host.docker.internal:8001/sse

这会使 LibreChat 连接到在 Docker 中运行的 MCP 服务器。

找到以下行:

socialLogins: ['github', 'google', 'discord', 'openid', 'facebook', 'apple', 'saml']

为简化操作，我们暂时取消身份验证要求：

socialLogins: []

使用 Ollama 添加本地 LLM（可选）​

安装 Ollama​

前往 Ollama 网站 并为您的系统安装 Ollama。

安装完成后，您可以按如下方式运行模型：

ollama run qwen3:32b

如果本地尚未存在该模型，该命令会自动将其拉取到本机。

有关模型列表,请参阅 Ollama library

在 librechat.yaml 中配置 Ollama​

模型下载完成后，在 librechat.yaml 中对其进行配置：

custom:
  - name: "Ollama"
    apiKey: "ollama"
    baseURL: "http://host.docker.internal:11434/v1/"
    models:
      default:
        [
          "qwen3:32b"
        ]
      fetch: false
    titleConvo: true
    titleModel: "current_model"
    summarize: false
    summaryModel: "current_model"
    forcePrompt: false
    modelDisplayLabel: "Ollama"

启动所有服务​

在 LibreChat 项目文件夹的根目录下，运行以下命令以启动服务：

docker compose up

等待所有服务完全启动并运行。

在浏览器中打开 LibreChat​

所有服务启动并运行后,打开浏览器并访问 http://localhost:3080/

如果您还没有 LibreChat 账号,请创建一个免费账号并登录。现在您应该能看到 LibreChat 界面已连接到 ClickHouse MCP 服务器,以及(可选)您的本地 LLM。

在聊天界面中,选择 clickhouse-playground 作为您的 MCP 服务器:

选择您的 MCP 服务器

现在您可以提示 LLM 探索 ClickHouse 示例数据集。试一试：

What datasets do you have access to?
注意

如果在 LibreChat UI 中没有看到 MCP 服务器选项， 请检查是否在 librechat.yaml 文件中正确配置了权限。

如果在 interface 下的 mcpServers 部分中将 use 设置为 false，则聊天界面中不会显示 MCP 服务器选择下拉框：

interface:
  mcpServers:
    use: true
    share: false
    create: false
    public: false