Integrace ClickHouse MCP serveru

K čemu slouží ClickHouse MCP Server?

ClickHouse MCP (Model Context Protocol) Server funguje jako robustní most propojující AI asistenty a jazykové modely s databázemi ClickHouse. Díky zpřístupnění standardizovaných nástrojů přes MCP umožňuje vývojářům a AI agentům provádět operace jako spouštění SQL dotazů, vypisování databází či procházení tabulek přímo na ClickHouse clusteru. Tato integrace zjednodušuje workflowy tím, že umožňuje automatizaci průzkumu databáze, vykonávání dotazů a získávání dat řízenou AI, a to při zachování bezpečnosti díky pouze-čtecím operacím a konfigurovatelným proměnným prostředí. Server je zvlášť efektivní pro vylepšení vývojářského prostředí, automatizaci analýzy dat a poskytování plynulého programového přístupu k výkonným funkcím ClickHouse.

Seznam promptů

V repozitáři ani dokumentaci nejsou uvedeny žádné šablony promptů.

Seznam zdrojů

V dostupné dokumentaci nejsou popsány žádné explicitní zdroje.

Seznam nástrojů

• run_select_query
  Spusťte SQL dotazy na vašem ClickHouse clusteru v bezpečném režimu pouze ke čtení. Přijímá vstup sql (řetězec) reprezentující SQL dotaz k provedení.

• list_databases
  Vypíše všechny databáze dostupné na vašem ClickHouse clusteru.

• list_tables
  Vypíše všechny tabulky ve zvolené databázi. Vyžaduje vstup database (řetězec) pro určení, kterou databázi procházet.

Příklady využití tohoto MCP serveru

• Správa a průzkum databáze
  Snadno vypište všechny databáze a tabulky, abyste rychle pochopili schéma a strukturu vašeho ClickHouse nasazení.

• Automatizované spouštění dotazů
  Programově spouštějte pouze-čtecí SQL dotazy, což umožňuje AI agentům získávat, analyzovat a sumarizovat data pro analytiku či reporting.

• Vývoj řízený daty
  Integrujte přístup k reálným datům do vývojářských workflow, což umožňuje dynamické prototypování, dashboarding či validační úlohy.

• Bezpečná automatizace analytiky
  Provádějte analytické úlohy s vynuceným pouze-čtecím přístupem, což zajišťuje integritu dat a soulad s bezpečnostními politikami.

• Integrace s AI-agenty
  Umožněte AI asistentům přímý přístup k ClickHouse pro získávání dat, čímž rozšíříte schopnosti chatbotů, asistentů nebo nástrojů pro automatizaci workflow.

Jak nastavit

Windsurf

V dokumentaci nejsou uvedeny žádné instrukce k nastavení pro Windsurf.

Claude

1. Otevřete konfigurační soubor Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

2. Přidejte následující konfiguraci do sekce mcpServers:

   {
     "mcpServers": {
       "mcp-clickhouse": {
         "command": "uv",
         "args": [
           "run",
           "--with",
           "mcp-clickhouse",
           "--python",
           "3.13",
           "mcp-clickhouse"
         ],
         "env": {
           "CLICKHOUSE_HOST": "<clickhouse-host>",
           "CLICKHOUSE_PORT": "<clickhouse-port>",
           "CLICKHOUSE_USER": "<clickhouse-user>",
           "CLICKHOUSE_PASSWORD": "<clickhouse-password>",
           "CLICKHOUSE_SECURE": "true",
           "CLICKHOUSE_VERIFY": "true",
           "CLICKHOUSE_CONNECT_TIMEOUT": "30",
           "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
         }
       }
     }
   }
   

3. Nahraďte zástupné hodnoty vašimi přihlašovacími údaji k ClickHouse.

4. Aktualizujte příkaz uv na absolutní cestu k vašemu spustitelnému souboru uv.

5. Restartujte Claude Desktop, aby se změny projevily.

Příklad pro ClickHouse SQL Playground:

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.13",
        "mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
        "CLICKHOUSE_PORT": "8443",
        "CLICKHOUSE_USER": "demo",
        "CLICKHOUSE_PASSWORD": "",
        "CLICKHOUSE_SECURE": "true",
        "CLICKHOUSE_VERIFY": "true",
        "CLICKHOUSE_CONNECT_TIMEOUT": "30",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
      }
    }
  }
}

Cursor

V dokumentaci nejsou uvedeny žádné instrukce k nastavení pro Cursor.

Cline

V dokumentaci nejsou uvedeny žádné instrukce k nastavení pro Cline.

Poznámka:
Všechny přihlašovací údaje ClickHouse by měly být zadávány prostřednictvím proměnných prostředí v sekci env konfiguračního JSON souboru, abyste zajistili, že citlivé informace jako API klíče a hesla nejsou zapsány natvrdo.

Příklad (proměnné prostředí pro přihlašovací údaje):

"env": {
  "CLICKHOUSE_HOST": "<clickhouse-host>",
  "CLICKHOUSE_PORT": "<clickhouse-port>",
  "CLICKHOUSE_USER": "<clickhouse-user>",
  "CLICKHOUSE_PASSWORD": "<clickhouse-password>"
}

Jak používat tento MCP ve flow

Použití MCP ve FlowHunt

Pro integraci MCP serverů do vašeho workflowu ve FlowHunt začněte přidáním MCP komponenty do svého flow a jejím propojením s AI agentem:

Klikněte na komponentu MCP, abyste otevřeli konfigurační panel. V sekci systémové konfigurace MCP vložte údaje o vašem MCP serveru v tomto JSON formátu:

{
  "mcp-clickhouse": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Po konfiguraci může AI agent tento MCP používat jako nástroj se všemi jeho funkcemi a možnostmi. Nezapomeňte změnit "mcp-clickhouse" na skutečný název vašeho MCP serveru a nahradit URL adresou vašeho serveru.

Přehled

Náš názor

ClickHouse MCP Server nabízí jasnou hodnotu pro vývojáře orientované na data, kteří potřebují LLM nebo AI-poháněný přístup k databázím ClickHouse. Repozitář však postrádá dokumentaci k šablonám promptů a zdrojovým primitivům a poskytuje pouze instrukce pro nastavení v Claude. Jeho sada nástrojů je silná pro dotazování databáze, ale absence informací o Roots a podpoře sampling snižuje jeho skóre v obecné MCP evaluaci.

MCP skóre

Konečné hodnocení:
Na základě kompletnosti dokumentace, srozumitelnosti nástrojů, otevřené licence a podpory komunity, ale se zohledněním chybějících sekcí o prompty, zdrojích a multiplatformním nastavení: 6/10