convez.ai
MCP ServerDevOps & InfraestruturaAvançado
reaatech

MCP Contract Kit

reaatech/mcp-contract-kit

Valide conformidade e compliance de servidores MCP com precisão

Ver no GitHub
InicialPluginScore · de 0 a 100

Suite 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-kit

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 2 meses
Versão
@reaatech/mcp-contract-validators@0.1.1
Issues abertas
7
Contribuidores
3

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

CI License: MIT TypeScript

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

PackageDescription
@reaatech/mcp-contract-coreCore domain types, JSON-RPC 2.0 schemas, and utilities
@reaatech/mcp-contract-clientMCP client SDK for connecting to MCP servers
@reaatech/mcp-contract-validatorsConformance validators (protocol, registry, routing, security, performance)
@reaatech/mcp-contract-reportersReport formatters (console, JSON, markdown, HTML)
@reaatech/mcp-contract-observabilityStructured logging, metrics, and tracing
@reaatech/mcp-contract-cliCLI tool and public API

Documentation

  • ARCHITECTURE.md — System design and package relationships
  • AGENTS.md — Coding conventions and development guidelines
  • CONTRIBUTING.md — Contribution workflow and release process
  • docs/ — Additional documentation

License

MIT

Ver o original no GitHub

Bom para

Relacionados