Wer eigene MCP Server für Claude Code bauen will, kämpft oft mit dem gleichen Problem: Es gibt viele Snippets, aber wenig strukturiertes Lernmaterial. Microsofts Open-Source-Projekt mcp-for-beginners schließt diese Lücke. Es ist ein vollständiges Curriculum, das MCP von Grund auf erklärt, mit echten Codebeispielen in vier Programmiersprachen.
Was ist mcp-for-beginners?
Das Model Context Protocol (MCP) ist der offene Standard, über den Claude Code externe Tools, APIs und Datenquellen einbindet. Statt alles in langen Prompts zu beschreiben, verbindet sich die KI per MCP direkt mit Diensten wie GitHub, Datenbanken oder eigenen Skripten.
mcp-for-beginners ist Microsofts strukturierte Antwort auf die Frage: Wie lerne ich MCP von Grund auf? Das Projekt stellt ein komplettes Lernprogramm bereit. Es durchläuft die Grundlagen des Protokolls Schritt für Schritt. Die Beispiele liegen in TypeScript, Python, .NET (C#) und Java, sodass du unabhängig von deinem Tech-Stack einsteigen kannst.
Das Curriculum richtet sich an Entwickler, die eigene MCP Server bauen oder das Protokoll tief verstehen wollen. Es erklärt nicht nur, wie man Server konfiguriert, sondern auch, warum MCP so aufgebaut ist. Die Kernidee: klare Abstraktionsschichten zwischen KI-Modell und externem Kontext, damit der Datenaustausch zuverlässig und sicher bleibt.
Wenn du noch nicht weißt, wie MCP-Server grundsätzlich funktionieren, empfehle ich zuerst den Beitrag MCP Server einfach erklärt. Danach macht das Curriculum deutlich mehr Sinn.
Was lernst du im Curriculum?
Das Lernprogramm gliedert sich in klar strukturierte Module. Du startest mit den Grundprinzipien: Was ist ein MCP-Host? Was ist ein MCP-Server? Wie läuft die Kommunikation zwischen beiden ab?
Darauf aufbauend folgen praktische Kapitel zu konkreten Themen:
- Tools: Wie registrierst du Funktionen, die Claude aufrufen kann?
- Resources: Wie stellst du Dateien oder Datenquellen als lesbaren Kontext bereit?
- Prompts: Wie definierst du wiederverwendbare Prompt-Vorlagen über MCP?
- Sampling: Wie kann ein MCP Server selbst Anfragen an ein Sprachmodell stellen?
Jedes Modul enthält funktionierende Codebeispiele, die du direkt ausführen kannst. Das ist ein klarer Unterschied zu vielen anderen Tutorials: Hier siehst du vollständige, lauffähige Implementierungen, keinen Pseudocode.
Die Kapitel bauen aufeinander auf, aber du kannst auch gezielt in einzelne Abschnitte einsteigen. Wer TypeScript beherrscht und Python nur grob kennt, kann sich auf die TypeScript-Beispiele konzentrieren und die anderen Sprachen überfliegen.
Wie nutzt du es mit Claude Code?
Das Curriculum ist kein Plugin, das du direkt einbindest. Es ist ein Lernpfad, der dich befähigt, eigene MCP Server zu schreiben. Der praktische Nutzen entsteht, wenn du das Gelernte anwendest.
Ein typischer Anwendungsfall: Du willst Claude Code mit deiner internen Unternehmensdatenbank verbinden. Ohne MCP-Kenntnisse ist das ein undurchsichtiges Unterfangen. Nach dem Curriculum weißt du, wie ein TypeScript-basierter MCP Server aufgebaut ist, der SQL-Abfragen als Tool freigibt.
Ein minimales Beispiel zeigt den Grundaufbau:
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new McpServer({
name: "mein-erster-mcp-server",
version: "1.0.0",
});
server.tool("hallo", "Sagt Hallo zurück", {}, async () => ({
content: [{ type: "text", text: "Hallo von meinem ersten MCP Server!" }],
}));
const transport = new StdioServerTransport();
await server.connect(transport);
Diesen Server bindest du danach in ~/.claude/settings.json ein. Claude Code kann das Tool dann in jeder Konversation aufrufen. Ab diesem Punkt wird das Curriculum konkret: Du verstehst nicht nur, was passiert, sondern kannst es selbst steuern.
Wann lohnt sich das Curriculum?
Das Lernmaterial lohnt sich besonders in drei Situationen.
Erstens: Du nutzt bereits MCP Server wie Context7 oder den GitHub-MCP-Server, willst aber verstehen, was dahintersteckt. Das Hintergrundwissen hilft dir, Fehler selbst zu debuggen, statt auf fertige Lösungen zu warten.
Zweitens: Du planst, eigene Tools für Claude Code zu bauen. Ob Datenbankzugriff, internes API-Gateway oder ein Skript für repetitive Aufgaben: Wer MCP versteht, kann Claude Code gezielt erweitern und ist nicht dauerhaft auf Server anderer angewiesen.
Drittens: Du arbeitest im Team und willst einheitliche Standards für MCP-Implementierungen etablieren. Das Microsoft-Curriculum ist gepflegt, gut dokumentiert und in der Community bekannt. Es eignet sich als gemeinsame Referenz, auf die sich alle im Team beziehen können.
Das Curriculum setzt JavaScript- oder Python-Grundkenntnisse voraus. Wer noch nie programmiert hat, sollte zuerst eine Sprache lernen. Für alle anderen ist der Einstieg mit dem TypeScript-Pfad gut machbar.
FAQ
Muss ich Microsoft Azure nutzen, um mcp-for-beginners zu verwenden?
Nein. Das Curriculum ist framework-agnostisch. Die Beispiele laufen lokal auf deinem Rechner ohne Azure-Abhängigkeit. Du kannst die gelernten Patterns direkt mit Claude Code und jedem beliebigen Backend nutzen.
Welche Programmiersprache sollte ich wählen?
Für Claude-Code-Workflows empfehle ich TypeScript. Das MCP-SDK ist für TypeScript am umfassendsten dokumentiert, und die meisten Community-Server sind ebenfalls in TypeScript geschrieben. Der Einstieg fällt dort am leichtesten.
Wie lange dauert es, das Curriculum durchzuarbeiten?
Mit soliden JavaScript-Kenntnissen kommst du durch die relevanten Kapitel an einem Wochenende. Wer zusätzlich die .NET- und Java-Abschnitte durcharbeitet, sollte mehr Zeit einplanen.
Wenn du tiefer in Claude Code, MCP und KI-gestütztes Development einsteigen willst: Komm in die kostenlose Claude Business Community. Du lernst dort Claude, Automatisierung, Co-Work, Claude Code, App-Building und Agent-Coding. Zeit sparen, Kosten sparen, Business skalieren. Jetzt kostenlos beitreten.
Marcel Porcher, newways.ai