Mijn eerste MCP server bouwen - wat ik leerde
Vorige week heb ik mijn eerste Model Context Protocol (MCP) server gebouwd en ik wil even delen hoe dat ging. Spoiler: makkelijker dan verwacht, maar er zijn addertjes.
Voor wie het niet kent: MCP is een protocol waarmee je AI-modellen (zoals Claude) toegang geeft tot externe tools en databronnen. Je bouwt een server die specifieke "tools" aanbiedt en het model kan die dan aanroepen tijdens een gesprek.
Ik heb een MCP server gemaakt die mijn Supabase database kan doorzoeken. Handig omdat ik nu in Claude Code kan vragen: "hoeveel nieuwe gebruikers hadden we deze week?" en hij draait gewoon de query.
Tech: TypeScript met de officiële @modelcontextprotocol/sdk package. De documentatie is OK maar niet geweldig - ik moest veel leren van GitHub voorbeelden van anderen.
Grootste les: houd je tools simpel. Mijn eerste versie had 12 tools en Claude raakte in de war over welke hij wanneer moest gebruiken. Teruggebracht naar 5 gerichte tools en het werkt veel beter.
Tweede les: input validation is cruciaal. Claude stuurt soms rare parameters mee die je server laten crashen als je niet valideert.
Als er interesse is kan ik een meer gedetailleerde walkthrough schrijven met code voorbeelden?
Reageer
floris_9141 dagen geleden
Ja graag die walkthrough! Ik wil ook een MCP server bouwen voor mijn project management setup - Supabase + Linear queries vanuit Claude. Die tip over minder tools is goud, had precies datzelfde probleem in een ander project.
tomm_8940 dagen geleden
Ik heb laatst een MCP server gemaakt voor het doorzoeken van mijn Markdown notities. Was verbaasd hoe makkelijk het was met de TypeScript SDK. Grootste valkuil bij mij was error handling - als je tool crasht krijg je in Claude een cryptische foutmelding zonder details.