Hoe verbind je DuckDB met Claude/Cursor via MCP (DuckDB MCP-serverconfiguratie)?

Bekijk alles wat Query Streams kunnen buiten deze handleiding Gratis aan de slag

Ondersteunt

+meer

Live gegevens

Export vervangen door SQL op aanvraag

Excel Vellen

BI & AI-analyse

Vraag Nova, krijg SQL + grafieken

Ontmoet Nova

Database REST API

Eén sleutel per partner. Geen inloggegevens worden gedeeld.

Bouw een API

+meer

Automatisering

Geplande synchronisatie naar 6+ platformen

Verken

+meer

API naar SQL

API's bevragen met SQL, geen code

Verken

+meer

AI-database MCP

Claude, Cursor, ChatGPT en Grok communiceren met uw gegevens.

Connect AI

Query Streams is een veilig, realtime data-integratieplatform dat elke database en SaaS API in uw account integreert in Claude, Cursor, ChatGPT en Grok — via één enkele MCP-sleutel en zonder dat er firewallwijzigingen nodig zijn. Deze handleiding beschrijft specifiek hoe u de DuckDB MCP-connector configureert, zodat uw AI-tool vragen in begrijpelijke taal kan beantwoorden over ingebedde analysedata — gebeurtenissen, gebruikers, transacties, dagelijkse totalen, cohortretentie, parquet-/CSV-/JSON-bestanden in S3 — zonder dat u CSV-exports vanuit de DuckDB CLI hoeft te kopiëren en plakken of handmatig code hoeft te schrijven. lees_park() vragen in een notitieboek. Meer informatie vindt u op QueryStreams.com en gratis aanmelden om je AI-tool echte DuckDB-vragen te gaan stellen.

Wat Query Streams MCP je biedt voor DuckDB

Andere "DuckDB MCP"-servers in het open-source-landschap verbinden de AI-tool rechtstreeks met een lokale server. .duckdb bestand. Dat werkt, maar het voegt een databasepad toe aan de configuratie van je AI-client, beperkt de AI-tool tot slechts dat ene DuckDB-bestand en geeft je geen auditlogboek van wat de AI daadwerkelijk heeft opgevraagd. De Query Streams MCP-server voor DuckDB lost een breder probleem op: één sleutel, elke connector (je DuckDB-bestanden plus al je andere databases en API's), een volledig auditlogboek en de AI-tool bewaart nooit je DuckDB-bestandspaden.

Hoe het werkt zonder firewallpoorten te openen

De Query Streams Network Agent wordt eenmalig geïnstalleerd op de machine waarop uw lokale gegevens staan. .duckdb bestand (een laptop, een lokale server of een kleine virtuele machine) en maakt één uitgaande TLS-verbinding met de cloud — er wordt nooit inkomend verkeer blootgesteld en de AI-tool ziet uw gegevens nooit. .duckdb bestandspad. Hoe werkt een verbinding die alleen uitgaand verkeer toelaat? →

De MCP-toets die je aan Cursor of Claude geeft, is beperkt (lezen / analyseren / uitvoeren), op elk moment herroepbaar en met een limiet per sleutel. De AI-tool roept deze MCP-tools aan om zijn werk te doen:

Waarom Schema Intelligence Query Streams MCP anders maakt

De meeste "MCP for DuckDB"-servers in het open-source landschap bieden je AI-tool dezelfde functionaliteit. informatie_schema DuckDB geeft je een onbekende. Kolomnamen. Gegevenstypen. Misschien een primaire sleutel. De LLM moet maar raden wat er aan de hand is. event_type = 7 betekent, wat nuttige lading opslag binnen de STRUCT, of gebeurtenissen.gebruikers_id sluit zich daadwerkelijk aan bij gebruikers.id (DuckDB-schema's hebben vaak geen gedeclareerde foreign keys, vooral wanneer tabellen zijn samengesteld uit parket lezen / read_csv_auto bronnen). Daarom is de eerste SQL-query die de meeste LLM's uitvoeren op een kaal schema onjuist — niet omdat de LLM slecht is, maar omdat deze niet over de benodigde gegevens beschikt om correct te zijn.

Query Streams MCP retourneert hetzelfde schema, verrijkt met wat wij noemen Schema-intelligentie (SI) — Door AI samengestelde metadata die wordt gegenereerd door profileringsquery's uit te voeren op uw gegevens. werkelijke DuckDB-gegevens voordat de AI-client erom vraagt. Wanneer SI is ingeschakeld op een connector en database, worden alle schematools die de AI aanroept (qs_get_connector_schema, qs_get_table_schema, qs_profiel_tabel, qs_get_relationships) retourneert het kale schema plus zes lagen aan zorgvuldig samengestelde kennis — inclusief hints over de JSON/STRUCT-vorm en richtlijnen voor kolomprojectie voor de kolomgeoriënteerde I/O van DuckDB. De LLM maakt een einde aan het giswerk.

Om dit concreet te maken, volgt hier wat de AI-client terugkrijgt van een enkele opdracht. qs_get_table_schema een oproep naar een typisch DuckDB embedded-analytics datawarehouse (evenementen, gebruikers, transacties, dagelijkse_aggregaten, experimenten) — eerst zonder schema-intelligentie, daarna mét.

De zes lagen die Schema Intelligence toevoegt

Elke laag behandelt een type vraag waar de LLM anders alleen maar naar zou gissen. De optionele SI-profileringsstap wordt uitgevoerd op uw DuckDB-gegevens zonder uw schema te wijzigen — en voor de scan opent de agent lokale bestanden. .duckdb bestanden in alleen-lezenmodus. Wat Schema Intelligence toevoegt en hoe het actueel blijft →

Dezelfde prompt, andere SQL-query

Het bewijs zit in de SQL-query's die de AI-tool daadwerkelijk genereert. Dezelfde cursorsessie, hetzelfde Claude-model, dezelfde prompt. "Toon me de omzetontwikkeling per cohort en evenementtype voor het laatste kwartaal, met wekelijkse gegevens." Zonder schema-intelligentie moet de LLM gissen. Met schema-intelligentie schrijft de LLM in één keer idiomatische, kolomvriendelijke DuckDB SQL.

Een lokaal DuckDB-bestand uitvoeren via Query Streams MCP

Query Streams MCP maakt verbinding met lokale DuckDB-databasebestanden. De netwerkagent opent uw .duckdb Het bestand wordt in de alleen-lezenmodus van DuckDB opgeslagen en de query's worden via dezelfde uitgaande cloudverbinding en dezelfde MCP-sleutel als bij alle andere connectors naar uw AI-client verzonden — er is geen aparte databaseserver nodig.

Is MCP niet jouw ding? Probeer dan Nova AI eens.

Sla de JSON-configuratie volledig over: Nova AI is geïntegreerd in het Query Streams-webportaal. en stelt dezelfde eenvoudige DuckDB-vragen aan je lokale .duckdb bestand — dezelfde agent, dezelfde alleen-lezen-handhaving, dezelfde schema-intelligentie, geen MCP-infrastructuur.

Maak kennis met Nova AI

Vereisten

Voordat je begint, zorg ervoor dat je het volgende hebt:

1. Een gratis Query Streams-account bij mijn.querystreams.nl.
2. De Query Streams Network Agent is geïnstalleerd op een machine waarop uw lokale gegevens staan. .duckdb bestand (een laptop, server of kleine VM) — zie Download de Query Streams Agent..
3. Een DuckDB-connector geconfigureerd voor de agent — zie de bestaande connector instellen handleidingen voor de .duckdb Het bestandspad. De agent bewaart het pad; de AI-tool raakt het nooit aan.
4. Elke AI-client die MCP ondersteunt. In deze handleiding laten we Cursor, Claude Desktop, ChatGPT en Grok zien; als je Windsurf, Zed, Continue, Cline, VS Code Copilot, Codex of Goose gebruikt, is het configuratieblok in principe hetzelfde.
5. Vijf minuten.

Stap 1: Genereer een MCP-sleutel in Query Streams

Meld u aan bij Query Streams en open de MCP-pagina (of meld u eerst aan bij mijn.querystreams.nl en klik MCP (in de linkernavigatie). Klik Sleutel genererenGeef de sleutel een herkenbare naam (iets zoals cursor-laptop of claude-desktop), en kies de bereiken die je aan deze sleutel wilt toevoegen:

• lezen — De AI kan connectoren doorzoeken en schema's lezen. Dat is voor al het andere nodig.
• analyseren — De AI kan tabellen profileren en relaties ontdekken (voorbeeldwaarden, verdelingen, semantische typen, hints over de structuur/lijst-vorm). Optioneel, maar sterk aanbevolen voor DuckDB-werk, waar inzicht in de structuur van geneste gegevens en de kardinaliteit van kolommen in enum-stijl ervoor zorgt dat de LLM in één keer kolomvriendelijke analyse-SQL kan schrijven.
• uitvoeren — De AI kan daadwerkelijk SQL-query's uitvoeren. Zonder dit kan de AI alleen schema-metadata lezen.

Voor een typische workflow zoals "Laat Claude mijn DuckDB-gegevens analyseren", zijn alle drie de scopes geschikt. Voor een sleutel die je aan een teamlid of een minder vertrouwde klant geeft, laat je deze scope weg. uitvoeren en laat ze alleen browsen. Je kunt elke sleutel op elk moment vanaf dezelfde pagina intrekken; de AI-client zal dit zien. MCP_KEY_REVOKED Bij de volgende oproep stopt het direct met werken. Er is geen vertraging in de signaaloverdracht.

Kopieer de sleutel nu — Query Streams toont deze eenmalig en slaat vervolgens alleen een hash op. Als u de sleutel kwijtraakt, genereer dan een nieuwe. De sleutel ziet er als volgt uit: qsmcp_ gevolgd door 48 willekeurige tekens, en dat is wat uw AI-client verzendt in de X-MCP-sleutel verzoekheader.

Stap 2: Voeg Query Streams MCP toe aan uw AI-client

De configuratie heeft dezelfde vorm voor elke MCP-compatibele client: een MCP-serververmelding die verwijst naar https://mcp.querystreams.com met uw sleutel in de X-MCP-sleutel Koptekst. Kies hieronder uw klant.

Cursor ~/.cursor/mcp.json

// Bewerk ~/.cursor/mcp.json
{
  "mcpServers": {
    "querystreams": {
      "url": "https://mcp.querystreams.com",
      "kopteksten": {
        "X-MCP-sleutel": "qsmcp_PLAK_HIER_SLEUTEL_"
      }
    }
  }
}

Claude Desktop claude_desktop_config.json

// Instellingen → Ontwikkelaar → Configuratie bewerken
{
  "mcpServers": {
    "querystreams": {
      "url": "https://mcp.querystreams.com",
      "kopteksten": {
        "X-MCP-sleutel": "qsmcp_PLAK_HIER_SLEUTEL_"
      }
    }
  }
}

ChatGPT Apps en connectoren

// Instellingen → Apps en connectors → MCP toevoegen
Server-URL  https://mcp.querystreams.com
Auth-header X-MCP-sleutel
Kopwaarde qsmcp_PLAK_HIER_SLEUTEL_

// Vereist een betaald ChatGPT-abonnement
// (Plus / Pro / Team / Enterprise).

Grok Externe MCP-tools

// Grok → Instellingen → Hulpmiddelen
{
  "mcp_servers": [{
    "naam": "querystreams",
    "url": "https://mcp.querystreams.com",
    "auth_header": "X-MCP-sleutel",
    "auth_value": "qsmcp_..."
  }]
}

Start uw AI-client opnieuw op. Bij de volgende opstart zal deze de acht hierboven vermelde Query Streams MCP-tools detecteren en in het toolpalet weergeven. In Cursor en Claude Desktop kunt u dit controleren door te typen “lijstconnectoren” — de AI zou moeten bellen qs_list_connectors en retourneer uw DuckDB-connector samen met alles wat u verder hebt geconfigureerd.

Stap 3: Stel de AI een DuckDB-vraag

Je hoeft geen SQL te schrijven, dat doet de AI. Je stelt een vraag, de AI kiest de juiste MCP-tool, de agent voert de query uit op je DuckDB-database en het antwoord krijg je terug als tekst plus tabellen. Drie voorbeeldvragen om mee te beginnen:

De eerste keer dat de AI een tool aanroept, kan er in uw client een bevestigingsmelding verschijnen waarin u wordt gevraagd de tooloproep goed te keuren. Dit is de standaard toestemmingsprocedure van MCP en geen extra functie van Query Streams. Keur de oproep eenmaal goed en de AI kan de rest van het gesprek zonder problemen voortzetten. U kunt de toestemming op elk gewenst moment opnieuw bekijken in de instellingen van uw client.

Veelgestelde vragen

Aan de slag

Gerelateerde handleidingen: Download de Query Streams Agent. | Databaseconnector instellen | Alle MCP Server-handleidingen | Nova AI tekst-naar-SQL

Categorie: MCP-server

Tags: mcp, claude, cursor, duckdb, analytics-database, developer-tools, embedded-analytics, columnar-database, parquet

Metabeschrijving: Verbind een lokaal DuckDB-bestand met Claude of Cursor via Query Streams MCP. Analysegericht, installatie in 5 minuten.