Skip to main content
このガイドでは、LangChain/LangGraph AIエージェントを構築し、 ClickHouse の SQL playgroundClickHouse の MCP server 経由で操作する方法を学びます。
Example notebookこのサンプルは、examples リポジトリ に notebook として用意されています。

前提条件

  • システムに Python がインストールされている必要があります。
  • システムに pip がインストールされている必要があります。
  • Anthropic の API キー、または他の LLM provider の API キーが必要です。
以下の手順は、Python REPL でもスクリプトでも実行できます。
1

ライブラリのインストール

次のコマンドを実行して、必要なライブラリをインストールします。
2

認証情報を設定する

次に、Anthropic APIキーを指定する必要があります。
Response
別のLLMプロバイダーを使用するAnthropic APIキーをお持ちでなく、別のLLMプロバイダーを使用したい場合は、 Langchain Providers docsで認証情報の設定手順を確認できます。
3

MCPサーバーを初期化する

次に、ClickHouse MCP serverがClickHouse SQL playgroundを参照するように設定します。
4

ストリームハンドラーを設定する

Langchain と ClickHouse MCP server を使用する場合、クエリ結果は単一のレスポンスではなく、ストリーミングデータとして返されることがよくあります。大規模なデータセットや、処理に時間がかかる可能性のある複雑な分析クエリでは、ストリームハンドラーを設定しておくことが重要です。適切に処理しないと、このストリーミング出力はアプリケーション内で扱いづらくなることがあります。ストリーミング出力を扱いやすくするため、ハンドラーを設定します:
5

エージェントに問い合わせる

最後に、エージェントに問い合わせて、ClickHouse に最も多くのコードをコミットしたのが誰かを確認します。
以下のような応答が表示されるはずです。
Response
最終更新日 2026年7月23日