chinese-text-tools

Caja de herramientas de escritura china para Claude Code: análisis de texto, generación de esquemas, referencias GB/T 7714, frecuencia de caracteres

GitHub

Documentación

Registro de MCP

El registro de 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 API en vivo | 👀 Visión del ecosistema | 📖 Documentación completa

Estado de Desarrollo

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

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

Grupo de Trabajo del Registro:

Contribuciones

Usamos 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:

Inicio rápido:

Requisitos previos

Ejecutar el 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 reinicia los contenedores, asegurando un estado limpio para desarrollo y pruebas.

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

Por defecto, el registro se siembra desde la API de producción con un subconjunto filtrado de servidores (para mantener el inicio rápido). Esto asegura que su entorno local refleje el comportamiento de producción y que todos los datos de siembra pasen la validación. Para desarrollo sin conexión, puede sembrar 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—consulte .env.example como referencia.

Alternativa: Ejecutar una imagen Docker preconstruida

Las imágenes Docker preconstruidas se publican automáticamente en GitHub Container Registry. Tenga en cuenta que la imagen no incluye PostgreSQL, por lo que debe ejecutar el suyo propio y apuntar el registro hacia él mediante MCP_REGISTRY_DATABASE_URL (consulte docker-compose.yml para un ejemplo funcional):

# 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:

  • Lanzamientos: latest, v1.0.0, v1.1.0, etc.
  • Continuo: main (última compilación de la rama principal)
  • Desarrollo: main-<date>-<sha> (compilaciones de commits específicos)

Publicar un servidor

Para publicar un servidor, hemos construido una CLI simple. Puede usarla con:

# Build the latest CLI
make publisher

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

Consulte la guía del publicador para 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. Ejecute make help para obtener más información, o consulte 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 propiedad de un dominio y sus subdominios
  • Verificación HTTP - Para demostrar 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 debe iniciar sesión en GitHub como domdomegg, o estar en una GitHub Action en los repositorios de domdomegg
  • me.adamjones/my-cool-mcp debe demostrar propiedad de adamjones.me mediante un desafío DNS o HTTP

Proyectos de la Comunidad

Consulte proyectos de la comunidad para explorar trabajos notables relacionados con el registro creados por la comunidad.

Más documentación

Consulte la documentación para más detalles si su pregunta no ha sido respondida aquí.