MCP Sentinel v1.0 Lançado: Um Lockfile para Esquemas de Ferramentas MCP

Há alguns dias, eu postei sobre um problema que encontrei com a deriva do esquema da ferramenta MCP.

A versão curta:

Um servidor MCP mudou um parâmetro de location para city.

Meu agente continuou enviando location.

Nada me avisou antes da execução.

Aquela primeira versão do MCP Sentinel era apenas a ideia básica:

sentinel init
sentinel snapshot
sentinel check
sentinel diff

Desde então, eu lancei MCP Sentinel v1.0.0.

GitHub:

https://github.com/Wannavf/mcp-sentinel

npm:

npm install -g @wannavf/mcp-sentinel

O enquadramento mudou um pouco

O problema original era irritante porque quebrou minhas ferramentas silenciosamente.

Mas após o feedback, eu acho que o ponto maior é este:

Os esquemas de ferramentas MCP são contratos.

Se uma ferramenta muda seus parâmetros, campos obrigatórios, valores de enumeração, formato de retorno ou descrições, isso não é apenas um pequeno detalhe de implementação.

Isso muda o que um agente pode solicitar.

Isso também pode mudar quando o agente decide usar essa ferramenta.

Isso importa muito para os servidores MCP ao redor:

databases
filesystems
cloud infrastructure
admin tools
internal APIs

Uma ferramenta de clima quebrada é irritante.

Uma ferramenta de banco de dados ou infraestrutura que muda silenciosamente pode ser muito pior.

O que v1.0 adiciona

A primeira versão era basicamente:

snapshot
check
diff

v1.0 agora tem um fluxo de trabalho mais completo.

sentinel init
sentinel discover --write
sentinel doctor
sentinel snapshot
sentinel check
sentinel diff

Descoberta

Agora você pode pedir ao Sentinel para encontrar servidores MCP a partir de locais de configuração comuns:

sentinel discover
sentinel discover --write

Ele pode procurar por configurações em formato MCP e ajudar a importar servidores para sentinel.config.json.

Isso torna a integração menos manual.

Doutor

Agora há uma verificação de configuração:

sentinel doctor

Ele verifica se o Sentinel pode ver sua configuração, se os servidores estão configurados corretamente e se o arquivo de bloqueio existe.

Em vez de adivinhar por que algo não funciona, você obtém uma verificação rápida de sanidade.

Painel

Há também um painel de terminal:

sentinel dashboard

ou:

sentinel db

Ele permite que você inspecione servidores configurados, instantâneas, verificações, atividades e deriva localmente.

Não é o recurso principal, mas é útil ao testar servidores MCP durante o desenvolvimento.

CI

O caso de uso principal ainda é CI.

sentinel check

Se um servidor mudou seu contrato de ferramenta, o CI pode falhar antes que o agente descubra a quebra em tempo de execução.

Há também uma Ação do GitHub:

name: Verificação de Esquema MCP
on: [pull_request]

jobs:
  drift:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: Wannavf/mcp-sentinel@main
        with:
          fail-on: MAJOR

Relatórios

O Sentinel pode gerar diffs em múltiplos formatos:

sentinel diff --format json
sentinel diff --format markdown
sentinel diff --format sarif

SARIF pode ser enviado para a Verificação de Código do GitHub.

Transportes

v1.0 suporta:

stdio
Streamable HTTP
SSE

Exemplo de configuração stdio:

{
  "compatibility": "BACKWARD",
  "failOn": "MAJOR",
  "servers": {
    "filesystem": {
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    }
  }
}

Exemplo de configuração HTTP:

{
  "servers": {
    "remote": {
      "transport": "http",
      "url": "http://localhost:3000/mcp"