Database Plain-English Query Skill

De Database Plain-English Query Skill is een gratis Claude-skill waarmee je je eigen database vragen stelt in gewone taal, zoals “hoeveel klanten hebben zich vorige maand aangemeld” of “top 10 producten op omzet”. Claude leest het echte schema, schrijft één SELECT, draait die via de Database-add-on van MCP Self-hosted en toont je de SQL naast het antwoord.

Wat geeft de Database Plain-English Query Skill terug?

Elke keer vier onderdelen:

• Het antwoord in één zin.
• Een kleine resultaattabel.
• De exacte SQL die is uitgevoerd, zodat je die zelf opnieuw kunt draaien of aanpassen.
• De aannames die zijn gedaan, bijvoorbeeld welke kolom als aanmelddatum is genomen of welke statuswaarden als betaald zijn geteld.

De aannames zijn het nuttige deel. “Omzet” kan ordertotalen betekenen, regeltotalen of totalen min terugbetalingen. De skill zegt welke hij gebruikte, zodat je het in één zin kunt corrigeren in plaats van later te ontdekken dat het getal niet klopte.

Hoe voorkomt de Database Plain-English Query Skill dat hij gokt?

Hij kijkt eerst en vraagt daarna. Eerst somt hij de tabellen op en beschrijft hij de tabellen die relevant lijken: kolomnamen, datatypes, nullable en standaardwaarden. Daarna draait hij een paar kleine verkenningsquery’s om echte waarden te zien, zoals de statuscodes in een orderstabel, het datumformaat of of bedragen in centen zijn opgeslagen. Pas dan schrijft hij de query die je vraag beantwoordt, met een expliciet datumbereik en een rijlimiet.

Dat kost een paar aanroepen meer dan meteen SQL schrijven. Het voorkomt ook de klassieke fouten: een kolomnaam die niet bestaat, een statusfilter op “paid” terwijl de tabel “completed” zegt, of een som in centen die als euro’s wordt gerapporteerd.

Welke tools gebruikt de Database Plain-English Query Skill?

De drie tools van de Database MCP-add-on:

• database_list_tables somt de basistabellen op. Views staan niet in die lijst, maar een SELECT op een view die je noemt werkt wel.
• database_describe_table geeft kolomnaam, type, nullable en standaardwaarde terug. Indexen en foreign keys toont hij niet, dus Claude leidt joins af uit kolomnamen en verkenningsquery’s.
• database_query draait één SQL-statement per aanroep. Resultaten stoppen standaard bij 200 rijen, en een query wordt standaard na 10 seconden afgebroken.

Beide limieten pas je zelf aan met DB_MAX_ROWS en DB_QUERY_TIMEOUT_MS. Bij vragen over totalen doet de limiet van 200 rijen er zelden toe: de skill groepeert en telt op in SQL, niet in de chat.

Kan de Database Plain-English Query Skill data wijzigen?

Nee. Hij schrijft alleen SELECT-statements, ook als de seat wijzigingen mag aanbrengen. De add-on heeft een eigen beveiliging: op een seat met alleen lezen wordt elk statement met INSERT, UPDATE of DELETE geweigerd, en CREATE, DROP, ALTER, TRUNCATE, GRANT en REVOKE worden in elke modus geweigerd. Die check werkt op trefwoorden, dus een SELECT met het woord “delete” in een tekstfilter wordt op een seat met alleen lezen ook geweigerd. Formuleer het filter dan anders.

De echte bescherming zit in je database, niet in Claude. Koppel de add-on met een databasegebruiker die alleen SELECT-rechten heeft, het liefst alleen op de tabellen die bevraagd mogen worden. De installatiehandleiding voor Database MCP legt uit hoe.

Wat heb je nodig voor de Database Plain-English Query Skill?

MCP Self-hosted en de Database-add-on. MCP Self-hosted kost € 217,80 excl. btw: € 180,00/jr inclusief 3 seats, en de Database-add-on is € 108,90 excl. btw: € 90,00 per jaar. De download is gratis en vraagt geen licentie.

De add-on werkt met MySQL, MariaDB en andere MySQL-compatibele databases, en met PostgreSQL. De verbindingsgegevens gaan in .env:

DB_TYPE=mysql
DB_HOST=db.example.com
DB_NAME=shop
DB_USER=claude_readonly
DB_PASSWORD=...

DB_PORT en DB_SSL zijn optioneel. Voor PostgreSQL stel je DB_TYPE=postgres in.

Hoe installeer je de Database Plain-English Query Skill?

1. Download hem via deze pagina. Afrekenen is gratis, en de zip verschijnt onder Skills in Mijn account.
2. Claude Code: pak uit in ~/.claude/skills/, of in .claude/skills/ voor één project.
3. Claude Desktop: voeg de zip toe via de skills-instellingen van Claude.
4. Stel een vraag waarvan je het antwoord al weet, en vergelijk.

Prompts die werken: “Hoeveel bestellingen kregen we per week dit kwartaal?”, “Welke klanten gaven vorig jaar meer dan 1.000 uit?” of “Wat is de gemiddelde orderwaarde per land?”

Voor wie is de Database Plain-English Query Skill?

Mensen die cijfers uit een database nodig hebben maar niet dagelijks SQL schrijven: accountmanagers, shopeigenaren, supportleads. Developers gebruiken hem ook, als snelle eerste versie van een query op een onbekend schema, met de SQL er meteen bij om te controleren.

De Database Plain-English Query Skill is gratis. Download hem hier, bekijk de andere skills in de catalogus met Claude-skills, of lees het overzicht gratis Claude-skills om te zien hoe skills en add-ons samenwerken.