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

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

uv のインストール

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

Open WebUI を起動するには、次のコマンドを実行してください。

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

ブラウザで http://localhost:8080/ を開き、UI を表示します。

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

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

では、mcpo を実行して OpenAPI エンドポイントを作成します:

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 Server を呼び出します。