mcp-builder: einen hochwertigen MCP-Server planen und umsetzen

Für wen

Nutze mcp-builder, wenn du einen hochwertigen MCP-Server (Model Context Protocol) erstellen willst, damit ein Modell über gut gestaltete Tools eine externe API oder einen Dienst aufrufen kann. Die Sprache kann Python (FastMCP) oder Node/TypeScript (MCP SDK) sein. Es ist eine Aufbauanleitung, kein Host für einen ungenannten Server.

Besser passt es, wenn du zuerst tief recherchieren und planen willst, statt sofort Schnittstellen zu schreiben. Das Material schreibt TypeScript als die Wahl mit besserer SDK-Unterstützung und besserer Kompatibilität in mehreren Laufzeiten (zum Beispiel MCPB). Es listet weder Agentenprodukte noch einen Repository-Installationspfad. Die offizielle Anleitungsseite ist

https://raw.githubusercontent.com/anthropics/skills/main/skills/mcp-builder/SKILL.md

Ersten Versuch in 3 Minuten abschließen

Diese Anleitung gibt keinen skill-Installationsbefehl; erfinde beim ersten Versuch keinen Pfad. Der empfohlene Weg beginnt bei Stufe eins: Deep Research and Planning. Ein hochwertiger MCP-Server hat vier Hauptstufen; der Auszug schreibt nur den Titel der ersten Stufe vollständig, also beim ersten Mal nur planen — keinen Serverprozess schreiben.

Voraussetzung: du hast bereits eine externe API oder einen Dienst zum Anbinden. Risikoarme Aktion: auflisten, welche Abfragen nur lesen und welche Daten ändern, und festlegen, dass remote Streamable HTTP nutzt. Die Zusammenfassung erwähnt stdio für lokal, der Auszug schreibt aber nur Streamable HTTP für remote; nimm nicht an, stdio-Argumente seien schon vollständig geschrieben.

Erfolgssignal: eine Seite kann klar sagen „welche Tools das Modell bekommt und welche Constraints die Eingaben nutzen“. Nicht zuerst npm init für ein ungeplantes Projekt. Nach bestätigter Planung in die Umsetzung. Auf der TypeScript-Seite kann Zod das Eingabe-schema übernehmen; Felder brauchen Constraints und klare Beschreibungen, Beispiele gehören in die Feldbeschreibungen. Vor dem Schreiben von Dateien das Verzeichnis bestätigen.

Anwendungsfälle

Fall 1: Einen Remote-Server auf dem empfohlenen TypeScript-Stack planen. MCP SDK wählen, Transport Streamable HTTP, Eingaben Zod, Constraints und Beispiele in die Beschreibungen. Die Zusammenfassung erwähnt auch outputSchema/structuredContent sowie Annotationen wie readOnlyHint und destructiveHint, der Auszug schreibt aber keine vollständigen Beispiele dieser Felder. Fertig ist dieser Fall, wenn der Plan nur-lesende Tools von datenändernden trennt, nicht wenn jede Annotation schon ausgefüllt ist. Nicht gleichzeitig einen Python-Satz als „Hauptweg“ starten; Python FastMCP und Pydantic sind parallele Optionen, kein Pflicht-Doppelschreiben.

Fall 2: Nach der Umsetzung kompilieren und prüfen. Der TypeScript-Weg ist zuerst npm run build zur Kompilierprüfung, dann MCP Inspector: npx @modelcontextprotocol/inspector. Inspector öffnet eine Prüfoberfläche und hat Nebenwirkungen; bestätigen, dass der gerade gebaute lokale oder Remote-Server getestet wird, dann ausführen. Fertig heißt: build besteht und Inspector erreicht den genannten Dienst. Der Auszug schreibt nicht alle Inspector-Flags; erfinde keine Verbindungsparameter.

Nutzungsgrenzen

Die vier Hauptstufen beginnen mit tiefer Recherche und Planung; später skizziert die Zusammenfassung umsetzen, dann prüfen/testen, aber die übrigen Stufentitel sind im Auszug nicht ausgeführt. Remote-Transport ist als Streamable HTTP geschrieben. Eingabe-schema nutzt Zod oder Pydantic. TypeScript-Prüfbefehle sind npm run build und der offizielle Inspector.

Erfinde keinen Installationspfad im Repository. Das Material gibt keine Client-Liste und sagt nicht, wie man Planung überspringt und direkt veröffentlicht. Jenseits dieser geschriebenen Stufen, Sprachoptionen und Prüfbefehle deckt diese Anleitung nichts ab.