Open WebUI で ClickHouse MCPサーバーを使用する

このガイドでは、Open WebUI を ClickHouse MCPサーバーと連携するようにセットアップし、 ClickHouse のサンプルデータセットに接続する方法を説明します。

uv をインストールする

このガイドの手順に従うには、uv をインストールする必要があります。 uv を使いたくない場合は、別のパッケージマネージャーを使うように MCPサーバーの設定を更新する必要があります。

Open WebUI を起動するには、次のコマンドを実行します。

uv run --with open-webui open-webui serve

UI を表示するには、http://localhost:8080/ にアクセスします。

ClickHouse MCPサーバーをセットアップするには、MCPサーバーを Open API エンドポイントに変換する必要があります。まず、ClickHouse SQL Playground に接続するための環境変数を設定します。

export CLICKHOUSE_HOST="sql-clickhouse.clickhouse.com"
export CLICKHOUSE_USER="demo"
export CLICKHOUSE_PASSWORD=""

そして、mcpo を実行して Open API エンドポイントを作成できます。

uvx mcpo --port 8000 -- uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse

http://localhost:8000/docs にアクセスすると、作成されたエンドポイントの一覧を確認できます。

これらのエンドポイントを Open WebUI で使用するには、設定画面に移動します。

Tools をクリックします。

http://localhost:8000 をツール URL として追加します。

これで、チャットバーのツールアイコンの横に 1 が表示されるはずです。

ツールアイコンをクリックすると、利用可能なツールの一覧を表示できます。

デフォルトでは、Open WebUI は Ollama モデルで動作しますが、OpenAI 互換のエンドポイントも追加できます。これらは設定メニューから構成しますが、今回は Connections タブをクリックする必要があります。

エンドポイントと OpenAI キーを追加します。

すると、OpenAI モデルが上部のメニューで利用できるようになります。

その後、会話を開始すると、必要に応じて Open WebUI が MCPサーバーを呼び出します。