⚡ MCP-Thor Blueprint
Blueprint oficial para geração de MCPs Vertikon com suporte completo a Go, TinyGo (WASM), Rust WASM e Web (React/Vite), alinhado à malha NATS descrita na Endurance.
🏆 VALIDATION STATUS: 100% COMPLETE ✅
Latest Validation: v13 (2025-11-13)
- ✅ 20/20 checks passing
- ✅ 0 critical issues
- ✅ 0 warnings
- ✅ 74.4% test coverage (target: 70%)
- ✅ Production ready
📊 Validation Evolution
| Version | Score | Status |
|---|---|---|
| v9 | 50% | Initial |
| v10 | 90% | Improved |
| v12 | 90% | Near complete |
| v13 | 100% | ✅ PRODUCTION READY |
🚀 Objetivos
- Entregar estruturas Clean Architecture prontas para produção.
- Automatizar criação da árvore .endurance e contratos NATS.
- Suportar fluxos Planejar → Executar → Validar com Claude Code.
🧩 Conteúdo
- scripts/: automações (setup-thor-blueprint.ps1, generate-mcp.ps1, setup-endurance-structure.ps1, validate-mcp.ps1).
- templates/: bases de código para Go, TinyGo/WASM, Rust/WASM e Web (React/Vite/TypeScript).
- config/: definições de features, malha NATS (YAML/JSON/CSV) e árvore .endurance.
- docs/: arquitetura, integração Claude Code, guia da malha NATS e setup rápido.
- examples/: MCPs de referência (estoque, live commerce, WhatsApp) e schemas.
- tools/: utilitários complementares (conversão de esquemas, validadores, gerador NATS).
- .github/: workflows para CI/CD e validação automática de templates.
🏁 Quick Start
Instalação
# 1. Instalar blueprint
cd E:\vertikon\.templates\mcp-thor
./scripts/setup-thor-blueprint.ps1 -InstallPath "E:\vertikon\.templates\mcp-thor"
# 2. Gerar estrutura Endurance (árvore completa)
./scripts/setup-endurance-structure.ps1 -DefinitionPath .\config\endurance-tree.yaml -Root "E:\vertikon\.endurance"Gerar Novos MCPs
# 3. Criar novo MCP Go
./scripts/generate-mcp.ps1 -Name "reserva-checkout" -Type go -Features rest,events,metrics
# 4. Criar módulo TinyGo (WASM app)
./scripts/generate-mcp.ps1 -Name "wasm-cart" -Type tinygo -Features wasm,ui
# 5. Criar aplicação Web
./scripts/generate-mcp.ps1 -Name "checkout-ui" -Type web -Features rest,ui
# 6. Criar módulo Rust WASM
./scripts/generate-mcp.ps1 -Name "payment-processor" -Type wasm -Features wasm
# 7. Validar
./scripts/validate-mcp.ps1 -Path "E:\vertikon\mcp-reserva-checkout"Usar Ferramentas
# Gerar configurações NATS
node tools/nats-generator.js mcp-inventory examples/inventory-schema.json ./config
# Validar projeto MCP
node tools/mcp-validator.js ./mcp-inventory
# Converter schemas
node tools/schema-converter.js schema.json openapi api.yaml
node tools/schema-converter.js schema.json asyncapi events.yaml✅ Definition of Done (DoD)
- Estrutura Clean Architecture aplicada.
- Cobertura ≥80% (tests table-driven + mocks gomock).
- Observabilidade (OpenTelemetry → Jaeger, Prometheus, logs estruturados).
- CI/CD base (GitHub Actions) incluída em cada MCP.
- Contratos NATS alinhados à config/nats-subjects.*.
- Documentação mínima: README, ADRs, OpenAPI/AsyncAPI.
📚 Referências
- docs/architecture/blueprint.md - Arquitetura detalhada
- docs/malha-nats.md - Guia da malha NATS Vertikon
- docs/setup/claude-code.md - Integração com Claude Code
- config/endurance-tree.yaml - Estrutura completa de projetos
- examples/inventory-schema.json - Schema de referência
- tools/README.md - Documentação das ferramentas
🛠️ Templates Disponíveis
Go Template
- Features: REST API, Eventos NATS, Métricas, gRPC
- Arquitetura: Clean Architecture completo
- Build: Makefile com testes, lint, validação
- CI/CD: GitHub Actions inclusos
TinyGo Template
- Features: Compilação WASM, UI básica
- Target: Navegador e sistemas embarcados
- Integração: WebAssembly Module
Web Template
- Features: React 18, TypeScript, Vite, Tailwind
- Componentes: UI library padrão
- Estado: React Query para gerenciamento
- Build: Otimizado para produção
Rust/WASM Template
- Features: Módulo WASM em Rust
- Integração: wasm-bindgen
- Testes: wasm-pack test
- Build: Compilação otimizada para web
🔄 Fluxo de Trabalho
- Definir Schema - Criar JSON schema com entidades/events
- Gerar NATS - Usar tools/nats-generator.js
- Criar MCP - Executar generate-mcp.ps1 com template escolhido
- Implementar - Desenvolver regras de negócio
- Validar - Usar tools/mcp-validator.js
- Documentar - Gerar OpenAPI/AsyncAPI com schema-converter.js
🔐 Licença
MIT. Consulte LICENSE.