メインコンテンツへスキップ
このガイドでは、OllamaでClickHouse MCPサーバーを使用する方法を説明します。
1

​
Ollama をインストールする

Ollama は、お使いのマシン上で大規模言語モデル (LLM) を実行するためのライブラリです。 利用可能なモデルの種類も豊富で、簡単に使えます。Ollama は Mac、Windows、Linux 向けに ダウンロードページ からダウンロードできます。Ollama を実行すると、モデルの実行に使えるローカルサーバーがバックグラウンドで起動します。 また、ollama serve を実行してサーバーを手動で起動することもできます。インストール後は、次のようにしてモデルをお使いのマシンにダウンロードできます。
モデルがローカルマシンにない場合は、これによりローカルマシンに取得されます。 ダウンロード後、次のようにモデルを実行できます:
MCPサーバーで利用できるのは、ツール対応モデルのみです。
ダウンロード済みのモデルは、次のように一覧表示できます。
ダウンロードしたmodelの詳細情報を確認するには、次のコマンドを使用します。
この出力から、デフォルトのqwen3モデルのパラメータ数は80億をわずかに超えていることがわかります。
2

​
MCPHostをインストールする

本稿執筆時点 (2025年7月) では、OllamaでMCPサーバーを利用するためのネイティブな機能はありません。 ただし、MCPHost を使えば、MCPサーバーと連携してOllamaのモデルを実行できます。MCPHostはGoアプリケーションであるため、使用するマシンにGoがインストールされていることを確認してください。 その後、次のコマンドを実行してMCPHostをインストールできます。
バイナリは ~/go/bin にインストールされるため、そのディレクトリが PATH に含まれていることを確認する必要があります。
3

​
ClickHouse MCP serverの設定

MCPHost を使用すると、YAML または JSON ファイルで MCPサーバーを設定できます。 MCPHost は、ホームディレクトリ内で次の順序で設定ファイルを探します。
  1. .mcphost.yml または .mcphost.json (推奨)
  2. .mcp.yml または .mcp.json (後方互換性のため)
標準の MCP 設定ファイルで使用される構文と似た構文を使用します。 以下は ClickHouse MCP server の設定例です。これを ~/.mcphost.json ファイルに保存します。
標準のMCP設定ファイルとの主な違いは、type を指定する必要がある点です。 type は、MCPサーバーで使用するトランスポートの種類を示すために使われます。
  • local → stdio トランスポート
  • remote → ストリーミング可能なトランスポート
  • builtin → inprocess トランスポート
また、以下の環境変数も設定する必要があります。
理論上は、MCP の設定ファイルで environment キーの下にこれらの変数を指定できるはずですが、実際にはうまく機能しないことがわかっています。
4

​
MCPHost の実行

ClickHouse MCPサーバーの設定が完了したら、次のコマンドでMCPHostを実行できます:
あるいは、特定の設定ファイルを使用する場合は:
--model を指定しない場合、MCPHost は環境変数から ANTHROPIC_API_KEY を参照し、anthropic:claude-sonnet-4-20250514 モデルを使用します。
次のような出力が表示されるはずです。
MCPサーバーを一覧表示するには、/servers コマンドを使用できます。
利用可能なツールを一覧表示するには、/tools を実行します:
その後、ClickHouse SQL Playground で利用可能なデータベースやテーブルについて、モデルに質問できます。私たちの経験では、小規模なモデルを使う場合 (デフォルトの qwen3 モデルは 80 億パラメータです) 、何をしてほしいのかをより具体的に指示する必要があります。 たとえば、いきなり特定のテーブルに対してクエリを実行するよう求めるのではなく、まずデータベースとテーブルの一覧を表示するよう明示的に依頼する必要があります。 この問題は、より大規模なモデル (例: qwen3:14b) を使うことである程度緩和できますが、一般的なハードウェアでは動作が遅くなります。
最終更新日 2026年6月19日