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

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

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

uvのインストール

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

Open WebUIの起動

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

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

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

ClickHouse MCPサーバーの設定

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 API endpoints

これらのエンドポイントをOpen WebUIで使用するには、設定に移動する必要があります:

Open WebUI settings

Toolsをクリックします:

Open WebUI tools

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

Open WebUI tool

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

Open WebUI tools available

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

Open WebUI tool listing

OpenAIの設定

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

Open WebUI connections

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

Open WebUI - Add OpenAI as a connection

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

Open WebUI - Models

Open WebUIを使用してClickHouse MCPサーバーとチャットする

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

Open WebUI - Chat with ClickHouse MCP Server