MCP Contract Kit
reaatech/mcp-contract-kit
Valide conformidade e compliance de servidores MCP com precisão
Ver no GitHubSuite de testes de conformidade para servidores MCP que valida aderência ao protocolo, compliance do registro e correção de roteamento. Fornece CLI, SDK de cliente, validadores e múltiplos formatos de relatório (console, JSON, Markdown, HTML) para testar implementações MCP contra a especificação.
Instalação
npx convez-ai reaatech/mcp-contract-kit1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Validar aderência de servidores MCP à especificação JSON-RPC 2.0
- Testar descoberta e execução de ferramentas em pipelines CI/CD
- Auditar postura de segurança (SSRF, autenticação, sanitização)
- Medir baseline de performance e limites de taxa de requisição
Veredito

Ferramenta essencial para times que desenvolvem servidores MCP, oferecendo conformance testing robusto com múltiplos validadores (protocolo, segurança, performance) e integração CI/CD. Implementação profissional com arquitetura modular e documentação técnica adequada.
README
A tradução para o português deste README ainda está na fila.
mcp-contract-kit
Conformance test suite for MCP servers. Validate registry compliance, protocol conformance, and routing correctness.
This monorepo provides a CLI tool, validators, MCP client SDK, and reporting infrastructure for testing Model Context Protocol (MCP) server implementations against the MCP specification.
Features
- Protocol conformance — JSON-RPC 2.0 compliance, tool discovery, tool execution, session management
- Registry validation — YAML schema validation, invariant checks, environment variable expansion
- Routing contracts — Request/response format validation, compatibility testing
- Security posture — SSRF protection, authentication checks, input sanitization
- Performance baseline — Latency measurement, concurrency testing, rate limit detection
- Multiple reporters — Console, JSON, Markdown, and HTML output formats
- Programmatic API — integrate into CI/CD pipelines
- MCP client SDK — connect to and test any MCP server
Installation
Using the packages
# CLI tool (includes all validators)
pnpm add @reaatech/mcp-contract-cli
# Individual packages
pnpm add @reaatech/mcp-contract-core
pnpm add @reaatech/mcp-contract-client
pnpm add @reaatech/mcp-contract-validators
pnpm add @reaatech/mcp-contract-reporters
pnpm add @reaatech/mcp-contract-observability
Contributing
git clone https://github.com/reaatech/mcp-contract-kit.git
cd mcp-contract-kit
pnpm install
pnpm build
pnpm test
pnpm lint
Quick Start
Test an MCP server:
mcp-contract-kit test http://localhost:8080 --suite all --format console
Or use the programmatic API:
import { runTests, generateReport } from "@reaatech/mcp-contract-cli";
const report = await runTests({ endpoint: "http://localhost:8080" });
console.log(report.passed ? "PASSED" : "FAILED");
Packages
| Package | Description |
|---|---|
@reaatech/mcp-contract-core | Core domain types, JSON-RPC 2.0 schemas, and utilities |
@reaatech/mcp-contract-client | MCP client SDK for connecting to MCP servers |
@reaatech/mcp-contract-validators | Conformance validators (protocol, registry, routing, security, performance) |
@reaatech/mcp-contract-reporters | Report formatters (console, JSON, markdown, HTML) |
@reaatech/mcp-contract-observability | Structured logging, metrics, and tracing |
@reaatech/mcp-contract-cli | CLI tool and public API |
Documentation
ARCHITECTURE.md— System design and package relationshipsAGENTS.md— Coding conventions and development guidelinesCONTRIBUTING.md— Contribution workflow and release processdocs/— Additional documentation
License
MIT