MotherDuck MCP Server

Do czego służy “MotherDuck” MCP Server?

MotherDuck MCP Server to implementacja Model Context Protocol (MCP), która łączy asystentów AI oraz IDE z bazami danych DuckDB i MotherDuck. Umożliwia użytkownikom wykonywanie zaawansowanej analityki SQL dzięki zunifikowanemu interfejsowi do zapytań zarówno do lokalnych plików DuckDB, jak i chmurowych baz MotherDuck. Serwer wspiera hybrydowe wykonywanie, zapewniając płynny dostęp do danych z lokalnych i chmurowych źródeł, w tym Amazon S3 przez integracje MotherDuck. Udostępniając interakcję z bazą jako narzędzie dla systemów AI, ułatwia deweloperom i agentom AI wykonywanie zapytań, zarządzanie danymi i automatyzację workflowów bez ręcznej konfiguracji czy obsługi serwerów. To podejście serverless przyspiesza analitykę, dzielenie się danymi i budowę pipeline’ów bezpośrednio ze środowisk zasilanych AI.

Lista promptów

• duckdb-motherduck-initial-prompt: Szablon prompta do inicjalizacji połączenia z DuckDB lub MotherDuck i rozpoczęcia pracy z bazą.

Lista zasobów

• Zamknij pętlę: Szybsze pipeline’y danych z MCP, DuckDB & AI (Blogpost): Post na blogu omawiający integrację MCP, DuckDB i AI w szybkim rozwoju pipeline’ów danych.
• Szybszy rozwój pipeline’ów danych z MCP i DuckDB (YouTube): Materiał wideo pokazujący wykorzystanie MCP i DuckDB przy pipeline’ach danych.

Lista narzędzi

• query: Wykonuje zapytanie SQL na bazie DuckDB lub MotherDuck.
  • Wejścia:
    • query (string, wymagane): Zapytanie SQL do wykonania.

Przypadki użycia tego MCP Servera

• Analityka SQL w asystentach AI: Umożliwia LLM-om lub asystentom kodu uruchamianie zapytań SQL bezpośrednio na DuckDB lub MotherDuck, przekładając polecenia w języku naturalnym na rzeczywistą analitykę.
• Budowa pipeline’ów danych: Przyspiesza tworzenie i prototypowanie pipeline’ów przez umożliwienie systemom AI pracy zarówno z lokalnymi, jak i chmurowymi źródłami danych.
• Hybrydowe zapytania lokalne i chmurowe: Wspiera scenariusze, w których deweloperzy muszą zapytania do danych on-premises (DuckDB) i chmurowych (MotherDuck) wykonywać płynnie, zwiększając elastyczność pracy.
• Integracja z magazynami chmurowymi: Agenci AI mogą pobierać i analizować dane przechowywane w Amazon S3 lub innych zintegrowanych chmurowych magazynach przez połączenia MotherDuck.
• Eksploracja danych w modelu serverless: Eliminuje potrzebę zarządzania infrastrukturą obliczeniową i pozwala na szybkie, natychmiastowe analizy dla użytkowników i systemów AI.

Jak skonfigurować

Windsurf

1. Upewnij się, że masz zainstalowane Node.js oraz Windsurf.

2. Otwórz plik konfiguracyjny Windsurf (zazwyczaj windsurf.config.json).

3. Dodaj MotherDuck MCP Server do sekcji mcpServers:

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

4. Zapisz konfigurację i zrestartuj Windsurf.

5. Sprawdź w Windsurf, czy MotherDuck MCP Server działa i jest dostępny.

Zabezpieczanie kluczy API

Użyj zmiennych środowiskowych do przekazywania wrażliwych danych, takich jak token MotherDuck:

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

Claude

1. Zainstaluj Claude i upewnij się, że Node.js jest skonfigurowany.

2. Znajdź plik konfiguracyjny Claude (zwykle claude.config.json).

3. Dodaj poniższe do sekcji mcpServers:

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

4. Uruchom ponownie Claude i sprawdź, czy serwer pojawia się w interfejsie.

5. Używaj zmiennych środowiskowych według powyższego wzoru dla bezpieczeństwa kluczy API.

Cursor

1. Upewnij się, że masz zainstalowany i zaktualizowany Cursor.

2. Otwórz ustawienia Cursor (cursor.config.json).

3. Wstaw poniższe do sekcji mcpServers:

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

4. Zapisz i zrestartuj Cursor.

5. Przekazuj poufne tokeny przez zmienne środowiskowe.

Cline

1. Zainstaluj Cline i wymagane zależności.

2. Edytuj cline.config.json, aby dodać:

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

3. Zapisz konfigurację i uruchom ponownie Cline.

4. Upewnij się, że motherduck_token jest ustawiony jako zmienna środowiskowa dla bezpieczeństwa.

Jak używać tego MCP w flowach

Używanie MCP w FlowHunt

Aby zintegrować serwery MCP z workflowem w FlowHunt, zacznij od dodania komponentu MCP do swojego flow i podłącz go do agenta AI:

Kliknij w komponent MCP, by otworzyć panel konfiguracji. W sekcji systemowej konfiguracji MCP wklej dane serwera w takim formacie JSON:

{
  "motherduck": {
    "transport": "streamable_http",
    "url": "https://twojmcpserver.przyklad/sciezka/do/mcp/url"
  }
}

Po konfiguracji agent AI może teraz korzystać z MCP jako narzędzia, mając dostęp do wszystkich jego funkcji i możliwości. Pamiętaj, by "motherduck" zamienić na faktyczną nazwę swojego serwera MCP i podać własny adres URL.

Podsumowanie

Wśród tych dwóch tabel MotherDuck MCP Server jest dobrze udokumentowany — posiada jasne prompty, wsparcie narzędzi, zasoby i praktyki bezpieczeństwa, ale nie ma jednoznacznej wzmianki o wsparciu Roots i Sampling. To solidna, praktyczna implementacja do analityki bazodanowej poprzez MCP.

Ocena MCP