ClickHouse MCP Sunucusu Entegrasyonu

“ClickHouse” MCP Sunucusu ne yapar?

ClickHouse MCP (Model Context Protocol) Sunucusu, AI asistanlarını ve dil modellerini ClickHouse veritabanlarına bağlayan sağlam bir köprü olarak görev yapar. MCP üzerinden standart araçları sunarak, geliştiricilerin ve AI ajanlarının SQL sorguları çalıştırma, veritabanlarını listeleme ve tabloları doğrudan bir ClickHouse kümesinde görüntüleme gibi işlemleri gerçekleştirmesine olanak tanır. Bu entegrasyon, veritabanı keşfi, sorgu yürütme ve veri çekme işlemlerinin AI destekli otomasyonunu güvenli salt-okunur işlemler ve yapılandırılabilir ortam ayarları ile kolaylaştırır. Sunucu, özellikle geliştirme ortamlarını geliştirmek, veri analizi otomasyonunu sağlamak ve güçlü ClickHouse özelliklerine sorunsuz, programatik erişim için etkilidir.

Komut Listesi

Depoda veya dokümantasyonda herhangi bir komut şablonundan bahsedilmemiştir.

Kaynak Listesi

Mevcut dokümantasyonda açıkça tanımlanmış herhangi bir kaynak yoktur.

Araçlar Listesi

• run_select_query
  ClickHouse kümenizde SQL sorgularını güvenli, salt-okuma modunda çalıştırır. Çalıştırılacak SQL sorgusunu temsil eden bir sql (string) girdisi alır.

• list_databases
  ClickHouse kümenizde mevcut olan tüm veritabanlarını listeler.

• list_tables
  Belirli bir veritabanındaki tüm tabloları listeler. Hangi veritabanının inceleneceğini belirtmek için database (string) girdisi gerektirir.

Bu MCP Sunucusunun Kullanım Alanları

• Veritabanı Yönetimi ve Keşfi
  ClickHouse kurulumunuzun şemasını ve yapısını hızlıca anlamak için tüm veritabanlarını ve tabloları kolayca listeleyin.

• Otomatik Sorgu Yürütme
  Salt okunur SQL sorgularını programatik olarak çalıştırarak, AI ajanlarının analiz veya raporlama için veri çekmesini, analiz etmesini ve özetlemesini sağlayın.

• Veri Odaklı Geliştirme
  Gerçek zamanlı veri erişimini geliştirme iş akışlarına entegre edin; bu, dinamik prototipleme, gösterge panosu oluşturma veya doğrulama görevleri için olanak sunar.

• Güvenli Analitik Otomasyonu
  Salt-okunur erişimle analitik görevleri gerçekleştirin, böylece veri bütünlüğünü ve güvenlik politikalarına uyumu sağlayın.

• AI Destekli Ajanlarla Entegrasyon
  AI asistanlarının ClickHouse ile doğrudan etkileşerek veri çekmesine izin verin; bu, sohbet botlarının, asistanların veya iş akışı otomasyon araçlarının yeteneklerini artırır.

Kurulum Nasıl Yapılır

Windsurf

Dokümantasyonda Windsurf için kurulum talimatı yer almıyor.

Claude

1. Claude Desktop yapılandırma dosyasını açın:

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

2. mcpServers bölümüne aşağıdaki yapılandırmayı ekleyin:

   {
     "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. Yer tutucu değerleri kendi ClickHouse kimlik bilgilerinizle değiştirin.

4. uv komutu için girişini kendi uv yürütülebilir dosyanızın mutlak yolu ile güncelleyin.

5. Değişikliklerin geçerli olması için Claude Desktop’ı yeniden başlatın.

ClickHouse SQL Playground için örnek:

{
  "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

Dokümantasyonda Cursor için kurulum talimatı yer almıyor.

Cline

Dokümantasyonda Cline için kurulum talimatı yer almıyor.

Not:
Tüm ClickHouse kimlik bilgileri, yapılandırma JSON’unun env bölümünde ortam değişkenleri olarak sağlanmalıdır; böylece API anahtarları ve şifreler gibi hassas bilgiler doğrudan yazılmaz.

Örnek (kimlik bilgileri için ortam değişkenleri):

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

Bu MCP Sunucusu Akışlarda Nasıl Kullanılır

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için, akışınıza MCP bileşenini ekleyin ve onu AI ajanınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırması bölümüne MCP sunucu bilgilerinizi bu JSON formatında girin:

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

Yapılandırdıktan sonra, AI ajanı artık bu MCP’yi tüm işlev ve yetenekleriyle bir araç olarak kullanabilir. "mcp-clickhouse" ifadesini gerçek MCP sunucu adınızla ve URL’yi kendi MCP sunucu adresinizle değiştirmeyi unutmayın.

Genel Bakış

Bizim Görüşümüz

ClickHouse MCP Sunucusu, LLM veya AI destekli ClickHouse veritabanı erişimi ihtiyacı olan veri odaklı geliştiriciler için net bir değer sunar. Ancak, depoda komut şablonları ve kaynak primitifleri hakkında dokümantasyon eksiktir ve yalnızca Claude için kurulum talimatı verilmiştir. Araç seti veritabanı sorgulama için güçlüdür, fakat Roots ve Örnekleme desteğiyle ilgili bilgi eksikliği genel MCP değerlendirmesi skorunu sınırlar.

MCP Skoru

Son değerlendirme:
Dokümantasyonun kapsamı, araçların netliği, açık lisans ve topluluk ilgisi göz önünde bulundurulduğunda, ancak komutlar, kaynaklar ve çoklu platform kurulumu bölümlerinin eksikliği dikkate alınarak: 6/10