AnythingLLMでClickHouse MCPサーバーを使う

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

Dockerをインストールする

LibreChat と MCPサーバーを実行するには Docker が必要です。Docker を入手するには、次の手順を実行します。

docker.com にアクセスします
お使いのオペレーティングシステム向けの Docker Desktop をダウンロードします
お使いのオペレーティングシステム向けの手順に従って Docker をインストールします
Docker Desktop を開き、起動していることを確認します

詳しくは、Docker documentation を参照してください。

AnythingLLMのDockerイメージをプルする

次のコマンドを実行して、AnythingLLM のDockerイメージをローカル環境にプルします。

docker pull anythingllm/anythingllm

ストレージの場所を設定する

ストレージ用のディレクトリを作成し、環境ファイルを初期化します。

export STORAGE_LOCATION=$PWD/anythingllm && \
mkdir -p $STORAGE_LOCATION && \
touch "$STORAGE_LOCATION/.env" 

MCPサーバーの設定ファイルを構成する

plugins ディレクトリを作成します。

mkdir -p "$STORAGE_LOCATION/plugins"

plugins ディレクトリに anythingllm_mcp_servers.json という名前のファイルを作成し、次の内容を追加します。

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.10",
        "mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
        "CLICKHOUSE_USER": "demo",
        "CLICKHOUSE_PASSWORD": ""
      }
    }
  }
}

自分のデータを調べたい場合は、自分の ClickHouse Cloud サービスのホスト、ユーザー名、パスワードを使用できます。

AnythingLLMのDockerコンテナーを起動する

次のコマンドを実行して、AnythingLLM のDockerコンテナーを起動します。

docker run -p 3001:3001 \
--cap-add SYS_ADMIN \
-v ${STORAGE_LOCATION}:/app/server/storage \
-v ${STORAGE_LOCATION}/.env:/app/server/.env \
-e STORAGE_DIR="/app/server/storage" \
mintplexlabs/anythingllm

起動したら、ブラウザで http://localhost:3001 にアクセスします。使用するモデルを選択し、API key を入力します。

MCPサーバーの起動を待つ

UI の左下にあるツールアイコンをクリックします。Agent Skills をクリックし、MCP servers セクションを確認します。 Mcp ClickHouse が On になるまで待ちます

AnythingLLMでClickHouse MCPサーバーとチャットする

これでチャットを始める準備ができました。 MCPサーバーをチャットで使えるようにするには、会話の最初のメッセージの先頭に @agent を付ける必要があります。

​Dockerをインストールする

​AnythingLLMのDockerイメージをプルする

​ストレージの場所を設定する

​MCPサーバーの設定ファイルを構成する

​AnythingLLMのDockerコンテナーを起動する

​MCPサーバーの起動を待つ

​AnythingLLMでClickHouse MCPサーバーとチャットする