MotherDuck MCP Sunucusu

“MotherDuck” MCP Sunucusu ne yapar?

MotherDuck MCP Sunucusu, AI asistanları ve IDE’leri DuckDB ile MotherDuck veritabanlarıyla birleştiren Model Context Protocol’ün (MCP) bir uygulamasıdır. Hem yerel DuckDB dosyalarında hem de bulut tabanlı MotherDuck veritabanlarında sorgu yapmayı standart bir arayüz sunarak güçlü SQL analitikleri yapılmasını mümkün kılar. Sunucu, hibrit yürütmeyi destekler; yerel ve bulut depolamadan (MotherDuck’ın Amazon S3 entegrasyonları dahil) sorunsuz veri erişimine olanak tanır. Veritabanı ile etkileşimi AI sistemlerine bir araç olarak açarak, geliştiricilerin ve AI ajanlarının veritabanı sorguları yapmasını, verileri yönetmesini ve veri iş akışlarını manuel yapılandırma ya da sunucu yönetimi olmadan kolayca düzenlemesini sağlar. Bu sunucusuz yaklaşım, doğrudan AI destekli ortamlardan analitiği, veri paylaşımını ve veri hattı geliştirmeyi hızlandırır.

Komut Listesi

• duckdb-motherduck-initial-prompt: DuckDB veya MotherDuck’a bağlanmak ve veritabanı ile çalışmaya başlamak için bir başlatma komut şablonu.

Kaynak Listesi

• Döngüyü Kapat: MCP, DuckDB & AI ile Daha Hızlı Veri Hatları (Blog yazısı): MCP, DuckDB ve AI entegrasyonunu ve hızlı veri hattı geliştirmesini ele alan blog yazısı.
• MCP ve DuckDB ile Daha Hızlı Veri Hattı Geliştirme (YouTube): MCP ve DuckDB’nin veri hatlarında kullanımını gösteren video kaynağı.

Araç Listesi

• query: DuckDB veya MotherDuck veritabanında bir SQL sorgusu çalıştırır.
  • Girdiler:
    • query (string, zorunlu): Çalıştırılacak SQL ifadesi.

Bu MCP Sunucusunun Kullanım Alanları

• AI Asistanlarında SQL Analitiği: LLM’lerin ya da kod asistanlarının doğrudan DuckDB veya MotherDuck üzerinde SQL sorguları çalıştırmasını, doğal dil talimatlarını analitik işlemlere dönüştürmesini sağlar.
• Veri Hattı Geliştirme: AI sistemlerinin hem yerel hem de bulut veri kaynaklarıyla etkileşime geçerek veri hatlarını daha hızlı geliştirmesine ve prototiplemesine olanak tanır.
• Hibrit Yerel & Bulut Sorgulama: Geliştiricilerin hem şirket içinde (DuckDB) hem de bulutta (MotherDuck) veri sorgulaması gereken senaryolarda, iş akışı esnekliğini artırır.
• Bulut Depolama Entegrasyonu: AI ajanları, MotherDuck bağlantıları üzerinden Amazon S3 veya entegre diğer bulut depolarda tutulan verilere erişebilir ve analiz edebilir.
• Sunucusuz Veri Keşfi: Hesaplama altyapısı ile uğraşmadan, kullanıcılar ve AI sistemleri için hızlı ve isteğe bağlı analitik sağlar.

Kurulum Nasıl Yapılır

Windsurf

1. Node.js ve Windsurf’ün kurulu olduğundan emin olun.

2. Windsurf yapılandırma dosyanızı açın (genellikle windsurf.config.json).

3. mcpServers bölümüne MotherDuck MCP Sunucusunu ekleyin:

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

4. Yapılandırmayı kaydedin ve Windsurf’ü yeniden başlatın.

5. Windsurf’te MotherDuck MCP Sunucusunun çalıştığını ve erişilebilir olduğunu doğrulayın.

API Anahtarlarını Güvenceye Alma

Hassas kimlik bilgilerinizi (ör. MotherDuck token) sağlamak için ortam değişkenlerini kullanın:

{
  "mcpServers": {
    "motherduck": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"],
      "env": {
        "motherduck_token": "${MOTHERDUCK_TOKEN}"
      }
    }
  }
}

Claude

1. Claude’u kurun ve Node.js’in yüklü olduğundan emin olun.

2. Claude yapılandırma dosyasını bulun (genellikle claude.config.json).

3. mcpServers bölümüne aşağıdakini ekleyin:

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

4. Claude’u yeniden başlatın ve sunucunun arayüzde göründüğünü doğrulayın.

5. API anahtarlarını güvenceye almak için yukarıdaki gibi ortam değişkenlerini kullanın.

Cursor

1. Cursor’ın kurulu ve güncel olduğundan emin olun.

2. Cursor ayarlarını açın (cursor.config.json).

3. mcpServers altına aşağıdakini ekleyin:

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

4. Kaydedin ve Cursor’ı yeniden başlatın.

5. Hassas anahtarları ortam değişkenleriyle ayarlayın.

Cline

1. Cline’ı ve gerekli bağımlılıkları kurun.

2. cline.config.json dosyasını düzenleyerek şunları ekleyin:

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

3. Yapılandırmayı kaydedin ve Cline’ı yeniden başlatın.

4. Güvenlik için motherduck_token ortam değişkeni olarak ayarlanmalıdır.

Bu MCP’yi Flow’larda Nasıl Kullanabilirsiniz

FlowHunt’ta MCP Kullanımı

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

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

{
  "motherduck": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırma tamamlandığında, AI ajanı artık bu MCP’yi, tüm fonksiyonlarına ve yeteneklerine erişebilen bir araç olarak kullanabilir. “motherduck” adını kendi MCP sunucunuzun adıyla ve URL’yi kendi MCP sunucu adresinizle değiştirmeyi unutmayın.

Genel Bakış

Bu iki tablo arasında, MotherDuck MCP Sunucusu net komutlar, araç desteği, kaynaklar ve güvenlik uygulamaları ile iyi belgelenmiştir; ancak Roots ve Örnekleme desteği açıkça belirtilmemiştir. Genel olarak, MCP arayüzü ile veri analitiği için sağlam ve pratik bir uygulamadır.

MCP Skoru