MCP-Registry

Die MCP-Registry bietet MCP-Clients eine Liste von MCP-Servern, ähnlich einem App Store für MCP-Server.

📤 Meinen MCP-Server veröffentlichen | ⚡️ Live-API-Dokumentation | 👀 Ökosystem-Vision | 📖 Vollständige Dokumentation

Entwicklungsstatus

Update vom 24.10.2025: Die Registry-API hat einen API-Freeze (v0.1) erreicht 🎉. Für den nächsten Monat oder länger bleibt die API stabil, ohne Breaking Changes, was es Integratoren ermöglicht, die Unterstützung zuverlässig zu implementieren. Dieser Freeze gilt für v0.1, während die Entwicklung an v0 fortgesetzt wird. Wir werden diesen Zeitraum nutzen, um die API in realen Integrationen zu validieren und Feedback zu sammeln, um die v1 für die allgemeine Verfügbarkeit zu gestalten. Vielen Dank an alle für Ihre Beiträge und Geduld – Ihr Engagement war entscheidend, um uns hierher zu bringen!

Update vom 08.09.2025: Die Registry wurde in einer Vorschauversion gestartet 🎉 (Ankündigungs-Blogbeitrag). Obwohl das System jetzt stabiler ist, handelt es sich immer noch um eine Vorschauversion, und es kann zu Breaking Changes oder Datenzurücksetzungen kommen. Eine Version für die allgemeine Verfügbarkeit (GA) folgt später. Wir freuen uns über Ihr Feedback in den GitHub-Diskussionen oder im #registry-dev Discord (Details zum Beitritt hier).

Aktuelle Hauptverantwortliche:

• Adam Jones (Anthropic) @domdomegg

• Tadas Antanavicius (PulseMCP) @tadasant

• Toby Padilla (GitHub) @toby

• Radoslav (Rado) Dimitrov (Stacklok) @rdimitrov

Mitwirken

Wir nutzen mehrere Kanäle für die Zusammenarbeit – siehe modelcontextprotocol.io/community/communication.

Oft (aber nicht immer) fließen Ideen durch diese Pipeline:

• Discord - Echtzeit-Community-Diskussionen

• Diskussionen - Produkt-/technische Anforderungen vorschlagen und diskutieren

• Issues - Gut abgegrenzte technische Arbeit verfolgen

• Pull Requests - Arbeit an Issues beisteuern

Schnellstart:

Voraussetzungen

• Docker

• Go 1.24.x

• ko - Container-Image-Builder für Go (Installationsanweisungen)

• golangci-lint v2.4.0

Server ausführen

# Start full development environment
make dev-compose

Dies startet die Registry unter localhost:8080 mit PostgreSQL. Die Datenbank verwendet flüchtigen Speicher und wird bei jedem Neustart der Container zurückgesetzt, was einen sauberen Zustand für Entwicklung und Tests gewährleistet.

Hinweis: Die Registry verwendet ko, um Container-Images zu erstellen. Der Befehl make dev-compose erstellt automatisch das Registry-Image mit ko und lädt es in Ihren lokalen Docker-Daemon, bevor die Dienste gestartet werden.

Standardmäßig wird die Registry aus der Produktions-API mit einer gefilterten Teilmenge von Servern gespeist (um den Start schnell zu halten). Dies stellt sicher, dass Ihre lokale Umgebung das Produktionsverhalten widerspiegelt und alle Seed-Daten die Validierung bestehen. Für die Offline-Entwicklung können Sie ohne Validierung aus einer Datei mit MCP_REGISTRY_SEED_FROM=data/seed.json MCP_REGISTRY_ENABLE_REGISTRY_VALIDATION=false make dev-compose speisen.

Das Setup kann mit Umgebungsvariablen in docker-compose.yml konfiguriert werden – siehe .env.example als Referenz.

Vorgefertigte Docker-Images werden automatisch in der GitHub Container Registry veröffentlicht:

# Run latest stable release
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:latest

# Run latest from main branch (continuous deployment)
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main

# Run specific release version
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:v1.0.0

# Run development build from main branch
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main-20250906-abc123d

Verfügbare Tags:

• Releases: latest, v1.0.0, v1.1.0 usw.

• Kontinuierlich: main (neuester Build des Hauptzweigs)

• Entwicklung: main-<datum>-<sha> (spezifische Commit-Builds)

Einen Server veröffentlichen

Um einen Server zu veröffentlichen, haben wir ein einfaches CLI erstellt. Sie können es wie folgt verwenden:

# Build the latest CLI
make publisher

# Use it!
./bin/mcp-publisher --help

Weitere Details finden Sie im Publisher-Leitfaden.

Andere Befehle

# Run lint, unit tests and integration tests
make check

Es gibt auch einige weitere hilfreiche Befehle für die Entwicklung. Führen Sie make help aus, um mehr zu erfahren, oder schauen Sie in das Makefile.

Architektur

Projektstruktur

├── cmd/                     # Application entry points
│   └── publisher/           # Server publishing tool
├── data/                    # Seed data
├── deploy/                  # Deployment configuration (Pulumi)
├── docs/                    # Documentation
├── internal/                # Private application code
│   ├── api/                 # HTTP handlers and routing
│   ├── auth/                # Authentication (GitHub OAuth, JWT, namespace blocking)
│   ├── config/              # Configuration management
│   ├── database/            # Data persistence (PostgreSQL)
│   ├── service/             # Business logic
│   ├── telemetry/           # Metrics and monitoring
│   └── validators/          # Input validation
├── pkg/                     # Public packages
│   ├── api/                 # API types and structures
│   │   └── v0/              # Version 0 API types
│   └── model/               # Data models for server.json
├── scripts/                 # Development and testing scripts
├── tests/                   # Integration tests
└── tools/                   # CLI tools and utilities
    └── validate-*.sh        # Schema validation tools

Authentifizierung

Die Veröffentlichung unterstützt mehrere Authentifizierungsmethoden:

• GitHub OAuth - Zur Veröffentlichung durch Anmeldung bei GitHub

• GitHub OIDC - Zur Veröffentlichung von GitHub Actions aus

• DNS-Verifizierung - Zum Nachweis des Eigentums an einer Domain und ihren Subdomains

• HTTP-Verifizierung - Zum Nachweis des Eigentums an einer Domain

Die Registry validiert bei der Veröffentlichung das Eigentum am Namespace. Z. B. um zu veröffentlichen...:

• io.github.domdomegg/my-cool-mcp müssen Sie sich bei GitHub als domdomegg anmelden oder sich in einer GitHub Action in domdomeggs Repos befinden

• me.adamjones/my-cool-mcp müssen Sie das Eigentum an adamjones.me per DNS- oder HTTP-Challenge nachweisen

Community-Projekte

Schauen Sie sich die Community-Projekte an, um bemerkenswerte, von der Community erstellte Arbeiten rund um die Registry zu erkunden.

Weitere Dokumentation

Siehe die Dokumentation für weitere Details, falls Ihre Frage hier nicht beantwortet wurde!