Repolode
Enviar
KryptosAI

KryptosAI/mcp-observatory

CLI open source de segurança e testes de regressão integrado ao CI para servidores MCP, com verificação de mudanças em schemas, simulação segura de ataques e saída SARIF.

Ver no GitHubSite
Estrelas
120
Forks
15
Issues abertas
20
Último commit
há 3 dias

O que é?

O MCP Observatory é uma ferramenta de linha de comando para testar servidores do Model Context Protocol (MCP) antes que agentes de IA dependam deles. Ela se conecta a um servidor, verifica suas tools, prompts e recursos, pode invocar tools seguras e somente de leitura para confirmar que funcionam e atribui uma pontuação de saúde de 0 a 100, acompanhada de uma classificação.

A ferramenta se concentra em verificações de regressão e segurança que se encaixam no CI. Ela pode registrar uma sessão do servidor em um arquivo cassette, reproduzi-la offline, verificar um servidor ativo com base nessa gravação e comparar duas execuções para destacar campos adicionados ou removidos e mudanças incompatíveis nos parâmetros. Também analisa schemas de tools em busca de padrões arriscados, como pontos vulneráveis a injeção de shell, acesso amplo ao sistema de arquivos e vazamento de credenciais.

Os resultados podem ser gerados em SARIF para o GitHub Code Scanning, e o comando setup-ci cria workflows do GitHub Actions ou do GitLab CI. O projeto também pode ser executado como servidor MCP, permitindo que um agente faça verificações em outros servidores. Requer Node.js 20 ou posterior e está disponível via npx, Homebrew e Docker.

Recursos principais

  • 01Verifica as tools, os prompts e os recursos de servidores MCP e informa uma pontuação de saúde de 0 a 100.
  • 02Detecta mudanças em schemas comparando duas execuções para identificar alterações adicionadas, removidas ou incompatíveis.
  • 03Registra sessões em cassettes e as reproduz ou verifica offline.
  • 04Executa simulações seguras de ataques e sinaliza padrões arriscados nos schemas das tools.
  • 05Exporta os resultados em SARIF e gera workflows do GitHub Actions ou do GitLab CI.
  • 06Pode ser executado como servidor MCP para que agentes testem outros servidores MCP.

Casos de uso

  • Adicionar uma verificação de segurança e compatibilidade ao pipeline de CI de um servidor MCP personalizado.
  • Detectar mudanças inesperadas nos schemas das tools antes que causem problemas para agentes que dependem do servidor.
  • Analisar servidores MCP de terceiros em busca de padrões arriscados nas tools antes de instalá-los.
  • Enviar os resultados das verificações de MCP ao GitHub Code Scanning em pull requests.

Início rápido

  1. 1

    Execute a primeira verificação com npx

    npx -y @kryptosai/mcp-observatory@latest
  2. 2

    Teste um servidor MCP específico

    npx -y @kryptosai/mcp-observatory@latest test npx -y @modelcontextprotocol/server-everything
  3. 3

    Abra o painel local para conferir os resultados

    npx -y @kryptosai/mcp-observatory@latest dashboard

Antes de usar

  • Requer Node.js 20 ou superior.
  • Alguns recursos avançados, como o fluxo de trabalho ClearFrame, dependem de um app para Mac compatível apenas com Apple Silicon.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCPFerramentas de CLI e terminalFerramentas de varredura, auditoria e inteligência de ameaçasFrameworks de teste e ferramentas de automação de testes

Tópicos

#mcp#security#testing#ci-cd#schema-drift#sarif#ai-agents#cli#agent-security#ai-agent

Perguntas frequentes

O que é mcp-observatory?
CLI open source de segurança e testes de regressão integrado ao CI para servidores MCP, com verificação de mudanças em schemas, simulação segura de ataques e saída SARIF. O MCP Observatory é uma ferramenta de linha de comando para testar servidores do Model Context Protocol (MCP) antes que agentes de IA dependam deles. Ela se conecta a um servidor, verifica suas tools, prompts e recursos, pode invocar tools seguras e somente de leitura para confirmar que funcionam e atribui uma pontuação de saúde de 0 a 100, acompanhada de uma classificação.
mcp-observatory é gratuito? Qual é a licença?
mcp-observatory é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-observatory ainda é mantido?
Manutenção ativa. O último commit de mcp-observatory foi em 4 de nov. de 2026.
Para que posso usar mcp-observatory?
Adicionar uma verificação de segurança e compatibilidade ao pipeline de CI de um servidor MCP personalizado. Detectar mudanças inesperadas nos schemas das tools antes que causem problemas para agentes que dependem do servidor. Analisar servidores MCP de terceiros em busca de padrões arriscados nas tools antes de instalá-los. Enviar os resultados das verificações de MCP ao GitHub Code Scanning em pull requests.
Como instalar mcp-observatory?
Execute a primeira verificação com npx: npx -y @kryptosai/mcp-observatory@latest Teste um servidor MCP específico: npx -y @kryptosai/mcp-observatory@latest test npx -y @modelcontextprotocol/server-everything Abra o painel local para conferir os resultados: npx -y @kryptosai/mcp-observatory@latest dashboard
Onde consigo mcp-observatory?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/KryptosAI/mcp-observatory

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados