メインコンテンツまでスキップ
メインコンテンツまでスキップ

ClickHouse MCPサーバーをLibreChatで使用する

このガイドでは、Dockerを使用してClickHouse MCPサーバーをセットアップし、それをClickHouseのサンプルデータセットに接続する方法を説明します。

Dockerのインストール

LibreChatとMCPサーバーを実行するにはDockerが必要です。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ファイルを開きます。OpenAI、Anthropic、AWSベッドロックなど、多くの人気のあるLLMプロバイダーのセクションが表示されます。例えば:

#============#

# 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の主な構成ファイルが作成されます。

DockerコンポーズにClickHouse MCPサーバーを追加する

次に、LLMがClickHouse SQLプレイグラウンドと対話できるように、LibreChat DockerコンポーズファイルにClickHouse MCPサーバーを追加します。

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ライブラリを参照してください。

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サーバーに接続されたLibreChatインターフェースが表示され、オプションでローカルLLMも表示されます。

チャットインターフェースから、MCPサーバーとしてclickhouse-playgroundを選択します:

MCPサーバーを選択

これで、LLMにClickHouseのサンプルデータセットを探索するように促すことができます。試してみてください:

What datasets do you have access to?