MCP Registry — Casos de uso, Instalar & Demo ao vivo

Name: MCP Registry MCP Server
Author: modelcontextprotocol

Por que usar

Principais recursos

Buscar MCPs por nome, capacidade ou runtime
Publicadores verificados e manifestos assinados
API REST pública (sem chave para leituras)
Auto-hospedável para registros internos/privados
Compatível com os ecossistemas Smithery e PulseMCP

Demo ao vivo

Como fica na prática

mcp-registry.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-registry",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-registry": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/registry-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add mcp-registry -- npx -y @modelcontextprotocol/registry-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: MCP Registry

Deixar o Claude buscar no registro oficial para encontrar um MCP para uma tarefa

👤 Qualquer pessoa que sabe o que quer fazer mas não qual MCP faz isso ⏱ ~10 min beginner

Quando usar: Você precisa de um MCP para Postgres/Notion/etc. e quer a escolha canônica.

Fluxo

Buscar

Use registry MCP. Find the top 3 results for keyword 'postgres' and tell me their stars + last update.✓ Copiado

→ Três candidatos com metadados
Inspecionar manifestos

For each, show config + tool list so I can pick.✓ Copiado

→ Manifestos renderizados
Instalar o escolhido

Install the top result into Claude Desktop.✓ Copiado

→ Bloco de configuração gravado em claude_desktop_config.json

Resultado: MCP escolhido a partir de fonte autoritativa em vez de resultados aleatórios de busca.

Armadilhas

MCPs mais recentes podem ainda não estar registrados — Cruze com FreeMCPLab e GitHub direto para escolhas da comunidade

Publicar seu MCP no registro oficial para que outros possam encontrá-lo

👤 Autores de MCP com um servidor estável e útil ⏱ ~30 min intermediate

Quando usar: Seu MCP tem 3+ usuários e você quer descobribilidade.

Pré-requisitos

Repositório GitHub com manifesto — server.json na raiz do repositório seguindo o schema do registro

Fluxo

Validar o manifesto

Use registry MCP to validate my server.json against the official schema. Tell me what's missing.✓ Copiado

→ Relatório de validação do schema
Submeter

Submit via the registry CLI. Auth using my GitHub identity.✓ Copiado

→ Submissão aceita; URL retornada
Verificar descobribilidade

Search for my MCP by name; confirm it appears.✓ Copiado

→ Visível na busca

Resultado: Seu MCP listado no registro oficial.

Executar um registro MCP interno para sua empresa

👤 Times de plataforma em organizações com MCPs internos ⏱ ~60 min advanced

Quando usar: Você tem MCPs proprietários que não quer no registro público.

Pré-requisitos

Runtime Go ou Docker — go install ou docker pull

Fluxo

Executar o servidor

Start the registry server on internal.mcp.corp. Configure auth.✓ Copiado

→ Servidor funcionando; endpoint de schema legível
Espelhar ou curar

Mirror selected public entries; add private ones from internal teams.✓ Copiado

→ Catálogo híbrido
Apontar o Claude para ele

Configure Claude Desktop to use the internal registry URL for discovery.✓ Copiado

→ Descoberta agora usa fonte interna

Resultado: MCPs internos governados e descobertos via seu próprio registro.

Combinações

Combine com outros MCPs para 10× de alavancagem

mcp-registry + mcp-go-mark3labs + mcp-python-sdk

SDK + registro — criar e depois publicar

Build with mcp-python-sdk; once stable, validate via registry MCP and submit.✓ Copiado

mcp-registry + awesome-mcp-servers-appcypher

Cruzar o registro com a lista awesome curada

If a server isn't in the registry yet, check the awesome list for community status.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
search_servers	query, runtime?, limit?	Descoberta
get_server	id	Página de detalhes
validate_manifest	manifest_json	Verificação antes da submissão
submit_server	manifest, github_token	Publicar seu MCP

Custo e limites

O que custa rodar

Cota de API: Leituras públicas sem autenticação; submissões precisam de auth GitHub
Tokens por chamada: Pequeno — manifestos são JSON
Monetário: Gratuito
Dica: Faça cache dos resultados de manifesto no lado cliente; eles não mudam com frequência

Segurança

Permissões, segredos, alcance

Escopos mínimos: github:read (para submissão)

Armazenamento de credenciais: Token GitHub em variável de ambiente apenas para submissão

Saída de dados: registry.modelcontextprotocol.io

Nunca conceda: github:write to private orgs

O registro público é centralizado; verifique a procedência antes de instalar MCPs não confiáveis

Solução de problemas

Erros comuns e correções

Falha de validação de schema

Compare seu server.json com o schema canônico em /schemas; campos ausentes são comuns

Submissão rejeitada

Verifique se a identidade GitHub corresponde ao publicador no manifesto; verifique se o repositório é público

Servidor não visível após submissão

A indexação pode levar alguns minutos; atualize a busca após 5 minutos

Alternativas

MCP Registry vs. outros

Alternativa	Quando usar	Troca
Smithery / PulseMCP	Você quer um diretório comercial polido	Índices de terceiros; este é o upstream
FreeMCPLab (este site)	Guias curados e demos práticos em vez de catálogo bruto	Formato diferente — playgrounds versus índice

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills