Agno와 ClickHouse MCP 서버로 AI 에이전트를 구축하는 방법
이 가이드에서는 ClickHouse의 SQL playground와 상호 작용할 수 있는 Agno AI 에이전트를 ClickHouse의 MCP 서버를 사용하여 구축하는 방법을 학습합니다.
예제 노트북
이 예제는 examples 저장소에 있는 노트북으로도 제공됩니다.
사전 요구 사항
- 시스템에 Python이 설치되어 있어야 합니다.
- 시스템에
pip이 설치되어 있어야 합니다. - Anthropic API 키 또는 다른 LLM 제공자의 API 키가 필요합니다.
다음 단계는 Python REPL에서 실행하거나 스크립트를 통해 실행할 수 있습니다.
라이브러리 설치
다음 명령어를 실행하여 Agno 라이브러리를 설치하십시오:
pip install -q --upgrade pip
pip install -q agno
pip install -q ipywidgets
자격 증명 설정
다음으로, Anthropic API 키를 입력해야 합니다:
import os, getpass
os.environ["ANTHROPIC_API_KEY"] = getpass.getpass("Enter Anthropic API Key:")
Enter Anthropic API Key: ········
다른 LLM 프로바이더 사용
Anthropic API 키가 없고 다른 LLM 프로바이더를 사용하려는 경우, 자격 증명 설정 방법은 Agno 문서에서 확인하실 수 있습니다.
다음으로, ClickHouse SQL 플레이그라운드에 연결하는 데 필요한 자격 증명을 정의합니다:
env = {
"CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
"CLICKHOUSE_PORT": "8443",
"CLICKHOUSE_USER": "demo",
"CLICKHOUSE_PASSWORD": "",
"CLICKHOUSE_SECURE": "true"
}
MCP 서버 및 Agno 에이전트 초기화
이제 ClickHouse MCP 서버가 ClickHouse SQL 플레이그라운드를 가리키도록 구성하고 Agno 에이전트를 초기화한 후 질문합니다:
from agno.agent import Agent
from agno.tools.mcp import MCPTools
from agno.models.anthropic import Claude
async with MCPTools(command="uv run --with mcp-clickhouse --python 3.13 mcp-clickhouse", env=env, timeout_seconds=60) as mcp_tools:
agent = Agent(
model=Claude(id="claude-3-5-sonnet-20240620"),
markdown=True,
tools = [mcp_tools]
)
await agent.aprint_response("What's the most starred project in 2025?", stream=True)
▰▱▱▱▱▱▱ Thinking...
┏━ Message ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ┃
┃ What's the most starred project in 2025? ┃
┃ ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
┏━ Tool Calls ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ┃
┃ • list_tables(database=github, like=%) ┃
┃ • run_select_query(query=SELECT ┃
┃ repo_name, ┃
┃ SUM(count) AS stars_2025 ┃
┃ FROM github.repo_events_per_day ┃
┃ WHERE event_type = 'WatchEvent' ┃
┃ AND created_at >= '2025-01-01' ┃
┃ AND created_at < '2026-01-01' ┃
┃ GROUP BY repo_name ┃
┃ ORDER BY stars_2025 DESC ┃
┃ LIMIT 1) ┃
┃ ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
┏━ Response (34.9s) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ┃
┃ To answer your question about the most starred project in 2025, I'll need to query the ClickHouse database. ┃
┃ However, before I can do that, I need to gather some information and make sure we're looking at the right data. ┃
┃ Let me check the available databases and tables first.Thank you for providing the list of databases. I can see ┃
┃ that there's a "github" database, which is likely to contain the information we're looking for. Let's check the ┃
┃ tables in this database.Now that we have information about the tables in the github database, we can query the ┃
┃ relevant data to answer your question about the most starred project in 2025. We'll use the repo_events_per_day ┃
┃ table, which contains daily event counts for each repository, including star events (WatchEvents). ┃
┃ ┃
┃ Let's create a query to find the most starred project in 2025:Based on the query results, I can answer your ┃
┃ question about the most starred project in 2025: ┃
┃ ┃
┃ The most starred project in 2025 was deepseek-ai/DeepSeek-R1, which received 84,962 stars during that year. ┃
┃ ┃
┃ This project, DeepSeek-R1, appears to be an AI-related repository from the DeepSeek AI organization. It gained ┃
┃ significant attention and popularity among the GitHub community in 2025, earning the highest number of stars ┃
┃ for any project during that year. ┃
┃ ┃
┃ It's worth noting that this data is based on the GitHub events recorded in the database, and it represents the ┃
┃ stars (WatchEvents) accumulated specifically during the year 2025. The total number of stars for this project ┃
┃ might be higher if we consider its entire lifespan. ┃
┃ ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
