𝗠𝗼𝗱𝗲𝗹 𝗖𝗼𝗻𝘁𝗲𝘅𝘁 𝗣𝗿𝗼𝘁𝗼𝗰𝗼𝗹 𝗨𝗶𝘁𝗴𝗲𝗹𝗲𝗴𝗱

Stop met het steeds opnieuw schrijven van dezelfde integratiecode.

Als je een LLM verbindt met een database of een API, schrijf je vaak voor elk nieuw model aangepaste glue code. Dit zorgt voor een puinhoop. Je eindigt met het beheren van talloze verbindingen voor talloze tools.

Het Model Context Protocol (MCP) lost dit op. Het werkt als een USB-C-poort voor AI. Je bouwt een tool één keer, en elk model kan deze gebruiken.

De architectuur bestaat uit drie onderdelen:

• Host: De app die je gebruikt, zoals Claude Code of een IDE. • Client: De connector binnen de host. • Server: Het programma dat je bouwt om data of tools beschikbaar te stellen.

Je kunt een MCP-server bouwen met behulp van drie belangrijke primitives:

  • Tools: Functies die het model aanroept om werk uit te voeren, zoals het versturen van een e-mail.
  • Resources: Alleen-lezen data die de app ophaalt, zoals een logbestand.
  • Prompts: Herbruikbare sjablonen voor specifieke taken.

Hier is hoe je een basis-server bouwt in Python met de FastMCP SDK:

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("demo-tools")

@mcp.tool()
def word_count(text: str) -> int:
    """Count words in a text."""
    return len(text.split())

@mcp.resource("notes://team")
def team_notes() -> str:
    """Expose team notes."""
    return "Release freeze starts Friday."

@mcp.prompt()
def code_review(language: str, code: str) -> str:
    """Template for code reviews."""
    return f"Review this {language} code: {code}"

if __name__ == "__main__":
    mcp.run()

Deze code regelt de complexe communicatie voor je. Je docstrings worden de instructies voor het model.

Drie tips voor productie:

  1. Beveiliging: Vraag altijd om goedkeuring van de gebruiker voordat je een tool uitvoert die gegevens wijzigt.
  2. Context: Houd toolbeschrijvingen kort. Lange beschrijvingen verspillen tokens.
  3. Fouten: Geef duidelijke berichten terug. Een model kan een "User not found"-fout oplossen, maar kan een crash in de broncode niet herstellen.

Stop met het bouwen van op maat gemaakte connectors. Bouw één keer een MCP-server en laat elk model deze gebruiken.

Bron: https://dev.to/galian/model-context-protocol-explained-build-your-first-mcp-server-in-python-ian