ClickHouse MCPサーバーとOllamaの使用法
このガイドでは、ClickHouse MCPサーバーをOllamaと共に使用する方法を説明します。
Ollamaのインストール
Ollamaは、自分のマシン上で大規模言語モデル(LLMs)を実行するためのライブラリです。 多様なモデルが利用可能で、使いやすいです。モデルのライブラリを参照してください。
Mac、Windows、またはLinux用のOllamaをダウンロードページからダウンロードできます。
Ollamaを実行すると、バックグラウンドでローカルサーバーが起動し、モデルを実行するのに使用できます。
または、ollama serve
を実行することでサーバーを手動で起動することもできます。
インストールが完了したら、次のようにモデルをローカルにプルすることができます:
これは、モデルが存在しない場合にローカルマシンにモデルをプルします。 ダウンロードが完了すると、次のようにモデルを実行できます:
MCPサーバーで動作するのは、ツールサポートがあるモデルのみです。
ダウンロードしたモデルを次のようにリストできます:
ダウンロードしたモデルに関する詳しい情報を表示するためのコマンドは次のとおりです:
この出力から、デフォルトのqwen3モデルが80億以上のパラメータを持っていることがわかります。
ClickHouse MCPサーバーの構成
MCPHostではYAMLまたはJSONファイルを使用してMCPサーバーを構成できます。 MCPHostは、以下の順序でホームディレクトリ内の設定ファイルを検索します:
.mcphost.yml
または.mcphost.json
(推奨).mcp.yml
または.mcp.json
(後方互換性)
これは、標準MCP設定ファイルで使用される構文に似た構文を使用しています。
以下は、~/.mcphost.json
ファイルに保存するClickHouse MCPサーバーの構成の例です:
標準MCP設定ファイルとの主な違いは、type
を指定する必要があることです。
タイプは、MCPサーバーが使用するトランスポートタイプを示すために使用されます。
local
→ stdioトランスポートremote
→ ストリーミングトランスポートbuiltin
→ プロセス内トランスポート
以下の環境変数も設定する必要があります:
理論的には、MCP設定ファイルのenvironment
キーの下でこれらの変数を指定できるはずですが、機能しないことがわかりました。
MCPHostの実行
ClickHouse MCPサーバーを構成したら、次のコマンドを実行してMCPHostを実行できます:
もしくは、特定の設定ファイルを使用する場合は:
--model
を指定しないと、MCPHostは環境変数のANTHROPIC_API_KEY
を探し、anthropic:claude-sonnet-4-20250514
モデルを使用します。
次の出力が表示されるはずです:
/servers
コマンドを使用してMCPサーバーをリストできます:
そして/tools
を使って利用可能なツールをリストします:
その後、ClickHouse SQLプレイグラウンドに利用可能なデータベース/テーブルに関してモデルに質問できます。
私たちの経験では、小さなモデル(デフォルトのqwen3モデルは80億のパラメータを持つ)を使用する際には、さらに具体的に求める必要があります。 たとえば、特定のテーブルをクエリする代わりに、データベースとテーブルをリストするように明示的に求める必要があります。 この問題は大きなモデル(例えば、qwen3:14b)を使用することで部分的に解消できますが、消費者向けハードウェアでは遅く動作します。