MCP Registry und server.json: Einträge richtig lesen
MCP-Registereinträge prüfen: Namensraum, server.json, Paket, Remote-Endpunkt und Version auseinanderhalten. Mit Prüfliste für die Auswahl eines Servers.
Sie finden mehrere MCP-Server mit ähnlichem Namen. Welcher Eintrag gehört zum gesuchten Projekt, welche Fassung wird beschrieben und welchen Startweg brauchen Sie? Ein Register bündelt Angaben, ersetzt aber nicht diese Auswahl. Lesen Sie die Identität des Eintrags, seine Herkunft und die angebotene Bereitstellung getrennt. So vermeiden Sie, einen bekannten Anzeigenamen mit einer passenden Installation oder einer geprüften Laufzeit gleichzusetzen.
Anzeigename, Namensraum und Paket unterscheiden
Das offizielle MCP Registry verwendet Namensräume. Bei GitHub-basierter Veröffentlichung folgt der Name beispielsweise dem Muster io.github.username/server; domainbasierte Veröffentlichung verwendet einen umgekehrten Domainnamen. Die Anmeldung zur Veröffentlichung belegt die Kontrolle des jeweiligen Namensraums. Sie ist keine allgemeine Qualitätsbewertung des Programms. Prüfen Sie weiterhin, ob die verlinkte Projektdokumentation tatsächlich das von Ihnen gesuchte Angebot beschreibt.
| Angabe | Was sie beschreibt | Ihre Gegenprüfung |
|---|---|---|
| Name und Namensraum | Identität im Register | Herausgeber und Projektzuordnung |
| Version | Fassung der Veröffentlichung | Passende Installationsanleitung |
| packages | Deklarierte Paketbereitstellung | Paketkennung und Laufzeit |
| remotes | Deklarierte entfernte Endpunkte | Transport, URL und Anmeldung |
Ein lesbarer Titel ist für die Orientierung gedacht. Für einen reproduzierbaren Vergleich halten Sie zusätzlich den vollständigen Registernamen fest. Zwei ähnlich klingende Titel können unterschiedliche Herausgeber haben. Umgekehrt können mehrere Einträge auf dasselbe Repository verweisen. Die Namensraumübersicht und der Vergleich helfen, solche Angaben nebeneinander zu betrachten.
server.json ist keine Clientkonfiguration
Die Datei server.json beschreibt eine Veröffentlichung für das Register. Sie kann Paketangaben und entfernte Bereitstellungen enthalten. Die Konfiguration Ihres Clients hat einen anderen Zweck: Sie legt fest, wie Ihr Client den Server startet oder erreicht. Kopieren Sie daher nicht das gesamte Registerdokument in eine Datei, die mcpServers oder servers erwartet. Eine ähnliche Dateiendung bedeutet keine austauschbare Struktur.
Verwenden Sie den Konfigurationsbaukasten als Ausgangspunkt und prüfen Sie anschließend die Anleitung des konkreten Clients. Welche Form der Übertragung möglich ist, erläutert die Anleitung zum Konvertieren. Eine erzeugte Vorlage installiert kein Paket und führt keinen Verbindungstest aus. Erst ein kontrollierter Versuch in Ihrer Umgebung zeigt, ob der gewählte Startweg funktioniert.
Eine Auswahl mit überprüfbaren Angaben treffen
Notieren Sie Aufgabe, Client und gewünschte Testoperation. Eine bekannte Projektmarke allein ist noch keine Anforderung.
Vergleichen Sie vollständigen Namen, Repository und dokumentierten Herausgeber. Öffnen Sie die Originalquelle und prüfen Sie, ob die Einrichtungsanleitung zum Eintrag passt.
Entscheiden Sie sich für genau eine angebotene Bereitstellung und halten Sie deren Version beziehungsweise Endpunkt fest.
Erstellen Sie die Clientkonfiguration und testen Sie eine begrenzte Operation. Dokumentieren Sie Ergebnis und offene Fragen getrennt von den Registerangaben.
Für Ihre eigene Auswahlliste genügen zunächst zwei bis vier Kandidaten. Notieren Sie pro Kandidat den vollständigen Namen, den benötigten Startweg, die Originalquelle und die noch ungeklärte Voraussetzung. Wenn ein Wert fehlt, schreiben Sie „offen“. Eine leere Angabe ist kein Nachweis, dass keine Voraussetzung existiert. So bleibt sichtbar, welcher Kandidat bereits zur Aufgabe passt und bei welchem zuerst eine Rückfrage oder Quellenprüfung nötig ist.
Registerstatus und tatsächlichen Betrieb auseinanderhalten
Ein Status wie active beschreibt den Registereintrag. Er bestätigt keinen erfolgreichen Abruf des Endpunkts in diesem Moment. Ebenso sagen deklarierte Pakete allein nichts darüber aus, ob die Installation auf Ihrem Rechner gelingt. tracevero zeigt erhobene Angaben und deren Herkunft; die Methodik erklärt diese Grenze. Lesen Sie Erhebungsdatum und Quelle mit, besonders wenn sich Dokumentation und Registereintrag widersprechen.
- Ist ein Registereintrag eine Sicherheitsprüfung?
- Nein. Veröffentlichungsregeln und Namensraumkontrolle sind von einer Prüfung des Laufzeitverhaltens zu unterscheiden.
- Kann ich server.json direkt als mcp.json verwenden?
- Nein. Die Dateien erfüllen unterschiedliche Aufgaben und haben unterschiedliche Strukturen.
- Beweist active, dass ein Endpunkt erreichbar ist?
- Nein. Prüfen Sie die Verbindung separat mit Ihrem Client.
- Was mache ich bei widersprüchlichen Versionsangaben?
- Vergleichen Sie Originalquelle, Erhebungsdatum und Installationsanleitung. Halten Sie den Widerspruch fest, statt still eine Fassung anzunehmen.
Offizielle Dokumentation geprüft am 1. Oktober 2026. Beispiele und Prüflisten sind redaktionelle Vorschläge.
- MCP Registry overview
Abrufbefehl anzeigen
curl -s https://modelcontextprotocol.io/registry/about - MCP Registry authentication
Abrufbefehl anzeigen
curl -s https://modelcontextprotocol.io/registry/authentication - MCP Registry FAQ
Abrufbefehl anzeigen
curl -s https://modelcontextprotocol.io/registry/faq - server.json reference
Abrufbefehl anzeigen
curl -s https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/server-json/generic-server-json.md