No ecossistema do hubMCP, separamos claramente duas peças fundamentais para gerenciar e apresentar servidores MCP de forma escalável, confiável e de baixo custo:

1. Registry: o Índice Canônico

O que é

O Registry é o “single source of truth” do hubMCP: um JSON versionado que contém metadados de todos os repositórios com o topic mcp-server — desde informações básicas até um QualityScore e selo de “Verified”.

Para que serve

• Coleta de dados em massa: não faz sentido que cada usuário ou site faça chamadas diretas e repetidas à GitHub API.
• Curadoria e confiabilidade: combinamos automação (QualityScore) e revisão manual (selo “Verified”) para criar um índice de alta qualidade.
• Histórico de mudanças: tudo fica registrado em commits, permitindo auditoria e rollback.

Workflow do Registry

1. GitHub Action periódica

   • Executa q=topic:mcp-server e lista todos os repositórios relevantes.
   • Para cada repo, extrai stars, forks, lastPushed, status de CI, alertas de vulnerabilidade etc.
   • Calcula um QualityScore baseado em métricas definidas (ex.: atividade recente, cobertura de testes, número de issues abertas etc.).
   • Atualiza registry/data/index.json e faz commit no próprio repositório.

2. Curadoria manual

   • Revisores abrem PRs para marcar certos servidores como "verified": true.
   • Com isso, adicionamos confiança extra ao índice — útil para organizações que querem listar apenas servidores validados.

3. Exemplo de trecho de index.json

   {
     "servers": [
       {
         "name": "awesome-mcp",
         "repo": "punkpeye/awesome-mcp-servers",
         "stars": 1250,
         "forks": 210,
         "lastPushed": "2025-04-15T12:30:00Z",
         "ciStatus": "passing",
         "vulnAlerts": 0,
         "qualityScore": 87,
         "verified": true
       },
       // ...
     ]
   }
   

2. Discovery: a Interface de Busca e Instalação

O que é

A Discovery é a mini‑app (site estático) que consome o JSON gerado pelo Registry e o transforma em uma interface amigável: filtros, ordenação por QualityScore, selo “Verified” e botão “Instalar”.

Para que serve

• Performance: tudo pré‑renderizado, sem chamadas dinâmicas à GitHub API em runtime.
• Custo zero por pesquisa: como o JSON já está pronto, não há limites nem latência de API.
• Experiência de usuário: páginas leves e instantâneas, hospedadas via GitHub Pages ou CDN.

Workflow da Discovery

1. Build / Deploy

   • Durante o build do site (Next.js, Hugo, Jekyll etc.), faz um curl https://raw.githubusercontent.com/hubmcp/registry/main/data/index.json (ou importa diretamente como módulo).
   • Gera páginas estáticas de listagem e detalhes, incluindo filtros por QualityScore, tópicos, linguagem, etc.

2. Execução no Cliente

   • Usuário acessa a página e recebe HTML/CSS/JS pré‑renderizados.
   • O botão “Instalar” abre um modal com instruções (por exemplo, npm install @mcp/awesome-mcp ou hubmcp install awesome-mcp).

3. Exemplo de comando no modal

   # Instalação rápida via hubMCP CLI
   $ hubmcp install punkpeye/awesome-mcp-servers
   

Benefícios da Arquitetura Separada

Aspecto	Registry	Discovery
Responsabilidade	Coleta, avaliação e curadoria de dados	Apresentação, busca e instalação
Frequência de atualização	Periódica (GitHub Actions ou manual)	Em deploy (build estático)
Dependências	GitHub API, Node.js, GitHub Actions	JSON estático, framework de front
Escalabilidade	Alto, pois roda em background	Instantânea, sem chamadas extras
Confiabilidade	Versão controlada + curadoria manual	Reflete dados curados pelo Registry

Próximos Passos

1. Aprimorar QualityScore
   • Ajustar pesos de métricas; incluir novos indicadores (ex.: downloads, issues resolvidas).
2. Design da Discovery
   • Refinar wireframes; destacar projetos mais ativos.
3. MCP CLI
   • Publicar um pacote npm (@hubmcp/cli) para facilitar hubmcp install.
4. Comunidade e Feedback
   • Criar um canal no Discord/Slack para sugestões de novos servidores e melhorias no índice.

Com essa separação clara entre ETL + Curadoria (Registry) e Interface + Distribuição (Discovery), o hubMCP garante um fluxo eficiente, confiável e de baixo custo. Pronto para levar a descoberta de servidores MCP ao próximo nível? 🚀

Fique de olho em nossos próximos posts!