ClickHouse MCPサーバーとOpen WebUIの使用

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

uvのインストール

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

Open WebUIを起動するには、次のコマンドを実行できます：

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

http://localhost:8080/ に移動して、UIを表示します。

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をクリックします：

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

これを行った後、チャットバーのツールアイコンの隣に1が表示されるはずです：

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

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

エンドポイントとOpenAIキーを追加しましょう：

OpenAIモデルは、トップメニューから利用可能になります：

その後、会話を行うことができ、必要に応じてOpen WebUIがMCPサーバーを呼び出します：