Как создать AI Agent с Agno и MCP-сервером ClickHouse

Настройка учетных данных

Далее вам потребуется указать API-ключ Anthropic:

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

Response

Enter Anthropic API Key: ········

Использование другого провайдера LLMЕсли у вас нет API-ключа Anthropic и вы хотите использовать другого провайдера LLM, инструкции по настройке учетных данных можно найти в документации Agno

Затем определите учетные данные, необходимые для подключения к Песочнице ClickHouse:

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

Инициализируйте MCP-сервер ClickHouse и агент Agno

Теперь настройте MCP-сервер ClickHouse так, чтобы он указывал на Песочницу ClickHouse, а затем инициализируйте агент 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)

Response

▰▱▱▱▱▱▱ Thinking...
┏━ Message ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃                                                                                                                 ┃
┃ Какой проект набрал больше всего звёзд в 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) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃                                                                                                                 ┃
┃ Чтобы ответить на ваш вопрос о проекте с наибольшим числом звёзд в 2025 году, мне нужно выполнить запрос к     ┃
┃ базе данных ClickHouse. Но сначала необходимо собрать некоторые сведения и убедиться, что мы работаем с         ┃
┃ нужными данными. Сначала проверю доступные базы данных и таблицы. Спасибо за предоставленный список баз         ┃
┃ данных. Вижу, что есть база данных "github" — она, скорее всего, содержит нужную нам информацию.               ┃
┃ Проверим таблицы в этой базе данных. Теперь, когда у нас есть сведения о таблицах в базе данных github,        ┃
┃ можно выполнить запрос к нужным данным и ответить на ваш вопрос о проекте с наибольшим числом звёзд в          ┃
┃ 2025 году. Воспользуемся таблицей repo_events_per_day, которая содержит ежедневное количество событий для       ┃
┃ каждого репозитория, включая события добавления звезды (WatchEvents).                                           ┃
┃                                                                                                                 ┃
┃ Составим запрос для поиска проекта с наибольшим числом звёзд в 2025 году. По результатам запроса могу          ┃
┃ ответить на ваш вопрос о проекте с наибольшим числом звёзд в 2025 году:                                         ┃
┃                                                                                                                 ┃
┃ Проектом с наибольшим числом звёзд в 2025 году стал deepseek-ai/DeepSeek-R1 — за этот год он набрал 84 962 звезды.┃
┃                                                                                                                 ┃
┃ Этот проект, DeepSeek-R1, судя по всему, является репозиторием организации DeepSeek AI, связанным с             ┃
┃ искусственным интеллектом. В 2025 году он вызвал широкий интерес и приобрёл большую популярность в             ┃
┃ сообществе GitHub, набрав больше звёзд, чем любой другой проект за этот год.                                    ┃
┃                                                                                                                 ┃
┃ Стоит отметить, что эти данные основаны на событиях GitHub, зафиксированных в базе данных, и отражают           ┃
┃ звёзды (WatchEvents), накопленные именно в течение 2025 года. Общее число звёзд этого проекта может быть        ┃
┃ выше, если учитывать весь период его существования.                                                             ┃
┃                                                                                                                 ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Как создать AI Agent с Agno и MCP-сервером ClickHouse

Предварительные требования

Установка библиотек

Настройка учетных данных

Инициализируйте MCP-сервер ClickHouse и агент Agno

​Предварительные требования

​Установка библиотек

​Настройка учетных данных

​Инициализируйте MCP-сервер ClickHouse и агент Agno

Предварительные требования

Установка библиотек

Настройка учетных данных

Инициализируйте MCP-сервер ClickHouse и агент Agno