본문으로 바로가기
본문으로 바로가기

ClickHouse MCP 서버를 사용하여 PydanticAI 에이전트를 구축하는 방법

이 가이드에서는 ClickHouse의 MCP 서버를 사용하여 ClickHouse의 SQL playground와 상호작용할 수 있는 PydanticAI 에이전트를 구축하는 방법을 알아봅니다.

예제 노트북

이 예제는 examples 저장소에 노트북으로 제공됩니다.

필수 조건​

  • 시스템에 Python이 설치되어 있어야 합니다.
  • 시스템에 pip가 설치되어 있어야 합니다.
  • Anthropic API key 또는 다른 LLM 프로바이더의 API key가 필요합니다.

다음 단계는 Python REPL 또는 스크립트에서 실행할 수 있습니다.

라이브러리 설치​

다음 명령을 실행하여 필요한 라이브러리를 설치하십시오:

pip install -q --upgrade pip
pip install -q "pydantic-ai-slim[mcp]"
pip install -q "pydantic-ai-slim[anthropic]" # 다른 LLM 프로바이더를 사용하는 경우 적절한 패키지로 교체

자격 증명 설정​

다음으로 Anthropic API key를 제공해야 합니다:

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

Enter Anthropic API Key: ········
다른 LLM 프로바이더 사용

Anthropic API key가 없고 다른 LLM 프로바이더를 사용하려는 경우, 자격 증명을 설정하는 방법은 PydanticAI docs에서 확인할 수 있습니다.

다음으로 ClickHouse SQL playground에 연결하는 데 필요한 자격 증명을 정의합니다:

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

MCP 서버 및 PydanticAI 에이전트 초기화​

이제 ClickHouse MCP 서버가 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("Who's done the most PRs for ClickHouse?")
    print(result.output)

You'll get back a similar response as below:

Based on the data from the ClickHouse GitHub repository, here are the top contributors by number of pull requests created:

**Top contributors to ClickHouse by PRs opened:**

1. **alexey-milovidov** - 3,370 PRs opened
2. **azat** - 1,905 PRs opened
3. **rschu1ze** - 979 PRs opened
4. **alesapin** - 947 PRs opened
5. **tavplubix** - 896 PRs opened
6. **kssenii** - 871 PRs opened
7. **Avogar** - 805 PRs opened
8. **KochetovNicolai** - 700 PRs opened
9. **Algunenano** - 658 PRs opened
10. **kitaisreal** - 630 PRs opened

**Alexey Milovidov** stands out as by far the most active contributor with over 3,370 pull requests opened, which is significantly more than any other contributor. This makes sense as Alexey Milovidov is one of the founders and lead developers of ClickHouse.

The data also shows that alexey-milovidov has been very active in managing PRs, with 12,818 "closed" events (likely reviewing and closing PRs from other contributors) in addition to creating his own PRs.

It's worth noting that I filtered out various robot/bot accounts that handle automated processes, focusing on human contributors to give you the most meaningful answer about who has contributed the most PRs to ClickHouse.