Registro MCP

El registro MCP proporciona a los clientes MCP una lista de servidores MCP, como una tienda de aplicaciones para servidores MCP.

📤 Publicar mi servidor MCP | ⚡️ Documentación de la API en vivo | 👀 Visión del ecosistema | 📖 Documentación completa

Estado del desarrollo

Actualización del 24-10-2025: La API del Registro ha entrado en congelación de API (v0.1) 🎉. Durante el próximo mes o más, la API permanecerá estable sin cambios disruptivos, lo que permitirá a los integradores implementar el soporte con confianza. Esta congelación se aplica a la v0.1 mientras continúa el desarrollo de la v0. Usaremos este período para validar la API en integraciones del mundo real y recopilar comentarios para dar forma a la v1 para su disponibilidad general. ¡Gracias a todos por sus contribuciones y paciencia; su participación ha sido clave para llegar hasta aquí!

Actualización del 08-09-2025: El registro se ha lanzado en vista previa 🎉 (publicación del blog de anuncio). Aunque el sistema es ahora más estable, sigue siendo una versión preliminar y pueden producirse cambios disruptivos o restablecimientos de datos. Una versión de disponibilidad general (GA) seguirá más adelante. Nos encantaría recibir sus comentarios en las discusiones de GitHub o en el Discord #registry-dev (detalles para unirse aquí).

Mantenedores clave actuales:

• Adam Jones (Anthropic) @domdomegg

• Tadas Antanavicius (PulseMCP) @tadasant

• Toby Padilla (GitHub) @toby

• Radoslav (Rado) Dimitrov (Stacklok) @rdimitrov

Contribución

Utilizamos múltiples canales para la colaboración: consulte modelcontextprotocol.io/community/communication.

A menudo (pero no siempre) las ideas fluyen a través de este proceso:

• Discord - Discusiones comunitarias en tiempo real

• Discusiones - Proponer y discutir requisitos técnicos/de producto

• Problemas - Seguimiento de trabajo técnico bien definido

• Solicitudes de extracción (Pull Requests) - Contribuir con trabajo para los problemas

Inicio rápido:

Requisitos previos

• Docker

• Go 1.24.x

• ko - Constructor de imágenes de contenedor para Go (instrucciones de instalación)

• golangci-lint v2.4.0

Ejecución del servidor

# Start full development environment
make dev-compose

Esto inicia el registro en localhost:8080 con PostgreSQL. La base de datos utiliza almacenamiento efímero y se restablece cada vez que reinicias los contenedores, lo que garantiza un estado limpio para el desarrollo y las pruebas.

Nota: El registro utiliza ko para crear imágenes de contenedor. El comando make dev-compose crea automáticamente la imagen del registro con ko y la carga en tu demonio Docker local antes de iniciar los servicios.

De forma predeterminada, el registro se alimenta de la API de producción con un subconjunto filtrado de servidores (para mantener el inicio rápido). Esto garantiza que tu entorno local refleje el comportamiento de producción y que todos los datos de inicio pasen la validación. Para el desarrollo sin conexión, puedes alimentar desde un archivo sin validación con MCP_REGISTRY_SEED_FROM=data/seed.json MCP_REGISTRY_ENABLE_REGISTRY_VALIDATION=false make dev-compose.

La configuración se puede ajustar con variables de entorno en docker-compose.yml - consulta .env.example para obtener una referencia.

Las imágenes de Docker preconstruidas se publican automáticamente en el Registro de contenedores de GitHub:

# 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

Etiquetas disponibles:

• Versiones: latest, v1.0.0, v1.1.0, etc.

• Continuas: main (compilación más reciente de la rama principal)

• Desarrollo: main-<fecha>-<sha> (compilaciones de confirmación específicas)

Publicar un servidor

Para publicar un servidor, hemos creado una CLI sencilla. Puedes usarla con:

# Build the latest CLI
make publisher

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

Consulta la guía del editor para obtener más detalles.

Otros comandos

# Run lint, unit tests and integration tests
make check

También hay algunos comandos más útiles para el desarrollo. Ejecuta make help para obtener más información, o mira en Makefile.

Arquitectura

Estructura del proyecto

├── 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

Autenticación

La publicación admite múltiples métodos de autenticación:

• GitHub OAuth - Para publicar iniciando sesión en GitHub

• GitHub OIDC - Para publicar desde GitHub Actions

• Verificación DNS - Para demostrar la propiedad de un dominio y sus subdominios

• Verificación HTTP - Para demostrar la propiedad de un dominio

El registro valida la propiedad del espacio de nombres al publicar. Por ejemplo, para publicar...:

• io.github.domdomegg/my-cool-mcp debes iniciar sesión en GitHub como domdomegg, o estar en una GitHub Action en los repositorios de domdomegg

• me.adamjones/my-cool-mcp debes demostrar la propiedad de adamjones.me mediante un desafío DNS o HTTP

Proyectos comunitarios

Consulta los proyectos comunitarios para explorar trabajos notables relacionados con el registro creados por la comunidad.

Más documentación

¡Consulta la documentación para obtener más detalles si tu pregunta no ha sido respondida aquí!