ClickHouse MCP Server を使用して PydanticAI エージェントを構築する方法

このガイドでは、ClickHouse の MCP Server を使って ClickHouse の SQL playground と対話できる PydanticAI エージェントを構築する方法を学びます。

例のノートブック

この例は、examples リポジトリ にあるノートブックとして提供されています。

前提条件

• システムにPythonがインストールされていること
• システムにpipがインストールされていること
• AnthropicのAPIキー、または他のLLMプロバイダーのAPIキー

以下の手順は、Python REPLまたはスクリプトから実行できます。

ライブラリをインストールする

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

pip install -q --upgrade pip
pip install -q "pydantic-ai-slim[mcp]"
pip install -q "pydantic-ai-slim[anthropic]" # 別のLLMプロバイダーを使用する場合は適切なパッケージに置き換えてください

資格情報の設定

次に、Anthropic の API キーを指定する必要があります。

import os, getpass
os.environ["ANTHROPIC_API_KEY"] = getpass.getpass("Enter Anthropic API Key:")

Anthropic APIキーを入力: ········

別の LLM プロバイダーを使用する場合

Anthropic の API キーをお持ちでなく、別の LLM プロバイダーを使用したい場合は、 認証情報の設定手順を PydanticAI のドキュメント で確認できます。

次に、ClickHouse SQL Playground に接続するために必要な認証情報を定義します。

env = {
    "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
    "CLICKHOUSE_PORT": "8443",
    "CLICKHOUSE_USER": "demo",
    "CLICKHOUSE_PASSWORD": "",
    "CLICKHOUSE_SECURE": "true"
}

MCP Server と PydanticAI エージェントの初期化

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

from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerStdio
from pydantic_ai.messages import ToolCallPart, ToolReturnPart

server = MCPServerStdio(
    'uv',
    args=[
        'run',
        '--with', 'mcp-clickhouse',
        '--python', '3.13',
        'mcp-clickhouse'
    ],
    env=env
)
agent = Agent('anthropic:claude-sonnet-4-0', mcp_servers=[server])

エージェントに質問する

最後に、エージェントに質問できます：

async with agent.run_mcp_servers():
    result = await agent.run("ClickHouseに最も多くのPRを行ったのは誰ですか？")
    print(result.output)

以下のような応答が返されます：

ClickHouse GitHubリポジトリのデータに基づくと、プルリクエスト作成数による上位貢献者は以下の通りです：

**PRオープン数によるClickHouseへの上位貢献者：**

1. **alexey-milovidov** - 3,370件のPRをオープン
2. **azat** - 1,905件のPRをオープン
3. **rschu1ze** - 979件のPRをオープン
4. **alesapin** - 947件のPRをオープン
5. **tavplubix** - 896件のPRをオープン
6. **kssenii** - 871件のPRをオープン
7. **Avogar** - 805件のPRをオープン
8. **KochetovNicolai** - 700件のPRをオープン
9. **Algunenano** - 658件のPRをオープン
10. **kitaisreal** - 630件のPRをオープン

**Alexey Milovidov**は、3,370件以上のプルリクエストをオープンしており、他のどの貢献者よりも圧倒的に活発な貢献者として際立っています。これは、Alexey MilovidovがClickHouseの創設者であり主要開発者の一人であることを考えると納得できます。

データはまた、alexey-milovidovが自身のPRを作成することに加えて、12,818件の「クローズ」イベント（おそらく他の貢献者からのPRをレビューしてクローズしている）を持ち、PRの管理においても非常に活発であることを示しています。

なお、自動化プロセスを処理する各種ロボット/ボットアカウントを除外し、人間の貢献者に焦点を当てることで、ClickHouseに最も多くのPRを貢献した人物について最も有意義な回答を提供しています。