Ship Your MCP Server

Preflight que barra o servidor MCP antes do registro público.

Como começar

1. Higiêne de repo e manifestosO primeiro nível não precisa do servidor de pé — roda só nos arquivos.python scripts/mcp_release_preflight.py /caminho/do/seu-mcp
2. Some o handshake real por stdioÉ onde a maioria dos servidores quebra: o handshake de verdade, não o manifesto.python scripts/mcp_release_preflight.py /caminho/do/repo --cmd "python -m meu_server"
3. Ou por streamable HTTPO mesmo gate contra um servidor já no ar — é o caminho que o cliente remoto usa.python scripts/mcp_release_preflight.py /caminho/do/repo --url http://127.0.0.1:8080/mcp
4. No CI, em uma linhaExit code 0 só quando nenhuma checagem FALHA; dá para rebaixar uma checagem aceita de propósito — fica registrado no relatório, nunca em silêncio.python scripts/mcp_release_preflight.py . --cmd "python -m meu_server" --json > preflight.json

Quando você vai usar

• Antes de submeter ao registry12 checagens com bloqueador nomeado, não aviso genérico. Exit code 0 só quando nenhum check FAILa — dá pra ser uma linha de CI.
• O servidor imprime no stdout e quebra o JSON-RPCA regra do stdio que derruba quase todo servidor na primeira submissão, verificada no handshake real.
• Manifesto fora de sincroniaserver.json, smithery.yaml e versão do pacote divergindo entre si é rejeição na hora — a skill compara os três.
• Chave vazando no repo.env fora do git, secret no código e SECURITY.md ausente barram a submissão antes do registry achar.
• Handshake antes de publicarSobe o servidor de verdade (stdio ou streamable HTTP) e fala MCP com ele antes que alguém faça isso por você em público.

O que vem no pacote

• scripts/mcp_release_preflight.py — o gate completo — stdlib puro, rede só contra o seu próprio server
• references/registry-listings.md — o que cada registry ingere e o que ele rejeita
• references/oauth-and-auth.md — caminho de auth do server remoto, falha por falha
• templates/server.json — manifesto de registry com a forma correta
• templates/smithery.yaml — manifesto do Smithery com a forma correta
• templates/SECURITY.md — política de segurança que os registries procuram

Precisa de

• Python 3.8+ (só stdlib)
• o repositório do servidor MCP
• opcional: --cmd ou --url para o handshake real

Onde ela não entra: Não registra nada por você — diz se passa. Check que você aceita conscientemente pode ser rebaixado com --allow, e o relatório registra o rebaixamento (nunca silencioso).

← todas as skills