MCP Ultra Wasm

MCP Ultra Templates

Projeto para transformar as bases MCP (mcp, sdk e mcp-wasm) em templates reutilizáveis via CLI, com observabilidade, pipeline CI e suporte a execução containerizada.

Sumário

• Requisitos
• Estrutura do Projeto
• Build & Testes
• Execução da CLI
• Trabalhando com Templates
• Modo Interativo
• Observabilidade
• CI/CD

Requisitos

• Go 1.22+
• Docker 24+ (opcional, para containerização)
• Docker Compose v2 (opcional)

Estrutura do Projeto

.
├── cmd/                       # CLI principal
├── internal/                  # Config, handlers, serviços, repositórios
├── pkg/                       # Pacotes compartilhados (log, metrics, template, etc.)
├── templates/                 # Templates disponíveis (mcp, sdk, mcp-wasm)
├── deploy/prometheus/         # Configuração Prometheus para docker-compose
├── tools/coverage             # Utilitário interno para cálculo de cobertura
├── Dockerfile                 # Build multi-stage da CLI
├── docker-compose.yaml        # Stack local com Prometheus + Jaeger
└── .github/workflows/ci.yml   # Pipeline de lint + testes

Build & Testes

# baixar dependências
go mod download

# build do binário CLI
go build -o bin/mcp-templates ./cmd

# execução de todos os testes
go test ./...

# testes com cobertura
go test ./... -coverprofile=coverage.out
go tool cover -func coverage.out

Execução da CLI

# listar templates disponíveis
go run ./cmd -- list

# renderizar template informando valores via --set
go run ./cmd -- render \
  --template mcp \
  --output ./out/mcp-service \
  --set module_name=github.com/example/mcp-service

Flags principais

Trabalhando com Templates

Exemplo para cada template:

# MCP
go run ./cmd -- render --template mcp --output out/mcp --set module_name=github.com/acme/mcp

# SDK
go run ./cmd -- render --template sdk --output out/sdk --set module_name=github.com/acme/sdk

# MCP WASM
go run ./cmd -- render --template mcp-wasm --output out/mcp-wasm --set module_name=github.com/acme/mcp-wasm

Modo Interativo

Use --interactive para preencher variáveis obrigatórias que ainda não possuam valor (via defaults, --set ou arquivo YAML). Exemplo:

go run ./cmd -- render \
  --template mcp \
  --output ./out/mcp-interactive \
  --interactive

Ao executar, a CLI exibirá prompts para cada variável obrigatória pendente, aplicando os defaults definidos em template.yaml sempre que possível.

Containerização & Docker Compose

Build do container

docker build -t mcp-templates-cli .

Stack local com observabilidade

docker compose up -d

# acessar shell do container para gerar projetos
docker compose exec cli mcp-templates list
docker compose exec cli mcp-templates render --template mcp ...

Volumes montados:

• ./templates → /workspace/templates (somente leitura)
• ./out → /workspace/out (saída dos projetos gerados)

Observabilidade

• Prometheus UI:
• Jaeger UI:
• Endpoint de métricas da CLI:

Variáveis de ambiente relevantes (configuradas no container):

CI/CD

Pipeline GitHub Actions (.github/workflows/ci.yml) executa:

1. golangci-lint (config em .golangci.yml)
2. go test ./... -coverprofile=coverage.out
3. Upload do arquivo de cobertura como artifact

Para replicar localmente o lint:

golangci-lint run ./...

Ficou com dúvida ou encontrou oportunidade de melhoria? Abra uma issue ou contribua diretamente! :rocket: