chinese-text-tools

Registro MCP

O registro MCP fornece aos clientes MCP uma lista de servidores MCP, como uma loja de aplicativos para servidores MCP.

📤 Publicar meu servidor MCP | ⚡️ Documentação da API ao vivo | 👀 Visão do ecossistema | 📖 Documentação completa

Status de Desenvolvimento

Atualização de 2025-10-24: A API do Registro entrou em um congelamento de API (v0.1) 🎉. Pelo próximo mês ou mais, a API permanecerá estável sem mudanças que quebrem a compatibilidade, permitindo que integradores implementem suporte com confiança. Este congelamento se aplica à v0.1 enquanto o desenvolvimento continua na v0. Usaremos este período para validar a API em integrações do mundo real e coletar feedback para moldar a v1 para disponibilidade geral. Agradecemos a todos pelas contribuições e paciência—sua participação foi fundamental para chegarmos até aqui!

Atualização de 2025-09-08: O registro foi lançado em pré-visualização 🎉 (postagem do blog de anúncio). Embora o sistema agora esteja mais estável, esta ainda é uma versão de pré-visualização e mudanças que quebram a compatibilidade ou redefinições de dados podem ocorrer. Uma versão de disponibilidade geral (GA) será lançada posteriormente. Adoraríamos seu feedback nas discussões do GitHub ou no #registry-dev Discord (detalhes de participação aqui).

Grupo de Trabalho do Registro:

• Tadas Antanavicius (PulseMCP) @tadasant
• Radoslav (Rado) Dimitrov (Stacklok) @rdimitrov
• Bob Dickinson (TeamSpark) @BobDickinson
• Preeti (Pree) Dewani (Ravenmail) @pree-dew

Contribuindo

Usamos vários canais para colaboração - veja modelcontextprotocol.io/community/communication.

Frequentemente (mas nem sempre) as ideias fluem por este pipeline:

• Discord - Discussões da comunidade em tempo real
• Discussões - Propor e discutir requisitos de produto/técnicos
• Issues - Acompanhar trabalho técnico bem definido
• Pull Requests - Contribuir com trabalho para as issues

Início rápido:

Pré-requisitos

• Docker
• Go 1.24.x
• ko - Construtor de imagens de contêiner para Go (instruções de instalação)
• golangci-lint v2.4.0

Executando o servidor

# Start full development environment
make dev-compose

Isso inicia o registro em localhost:8080 com PostgreSQL. O banco de dados usa armazenamento efêmero e é redefinido a cada reinicialização dos contêineres, garantindo um estado limpo para desenvolvimento e testes.

Nota: O registro usa ko para construir imagens de contêiner. O comando make dev-compose automaticamente constrói a imagem do registro com ko e a carrega no seu daemon Docker local antes de iniciar os serviços.

Por padrão, o registro é inicializado a partir da API de produção com um subconjunto filtrado de servidores (para manter a inicialização rápida). Isso garante que seu ambiente local espelhe o comportamento de produção e que todos os dados de seed passem pela validação. Para desenvolvimento offline, você pode inicializar a partir de um arquivo sem validação com MCP_REGISTRY_SEED_FROM=data/seed.json MCP_REGISTRY_ENABLE_REGISTRY_VALIDATION=false make dev-compose.

A configuração pode ser ajustada com variáveis de ambiente em docker-compose.yml - veja .env.example como referência.

# 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

Publicando um servidor

Para publicar um servidor, construímos uma CLI simples. Você pode usá-la com:

# Build the latest CLI
make publisher

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

Veja o guia do publicador para mais detalhes.

Outros comandos

# Run lint, unit tests and integration tests
make check

Há também alguns comandos úteis adicionais para desenvolvimento. Execute make help para saber mais, ou consulte o Makefile.

Arquitetura

Estrutura do Projeto

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

Autenticação

A publicação suporta vários métodos de autenticação:

• GitHub OAuth - Para publicar fazendo login no GitHub
• GitHub OIDC - Para publicar a partir do GitHub Actions
• Verificação DNS - Para provar a propriedade de um domínio e seus subdomínios
• Verificação HTTP - Para provar a propriedade de um domínio

O registro valida a propriedade do namespace ao publicar. Por exemplo, para publicar...:

• io.github.domdomegg/my-cool-mcp você deve fazer login no GitHub como domdomegg, ou estar em uma GitHub Action nos repositórios de domdomegg
• me.adamjones/my-cool-mcp você deve provar a propriedade de adamjones.me via desafio DNS ou HTTP

Projetos da Comunidade

Confira projetos da comunidade para explorar trabalhos notáveis relacionados ao registro criados pela comunidade.

Mais documentação

Veja a documentação para mais detalhes se sua pergunta não foi respondida aqui!