Um servidor MCP que coloca 48 ferramentas determinísticas de arquitetura e 10 personas de arquiteto dentro do seu agente de código. O modelo do seu cliente raciocina; o servidor devolve cálculos, estruturas, fontes oficiais e lacunas explícitas. O servidor nunca chama um modelo, nunca acessa a sua conta pela internet e não precisa de chave de API.
Feito por Fernando Azevedo, Arquiteto de Tecnologia da Informação Especialista e AWS Community Builder (AI Engineering). É o que eu uso para decidir arquitetura no dia a dia, aberto para a comunidade usar, auditar e estender.
Veja funcionando
Pede uma API, ele pergunta antes de sugerir. O agente chama requirements_check e depois architect_panel; nenhum número é inventado.
Calcula, não chuta. No Kiro, latency_budget soma os passos em série, pega o maior dos paralelos e mostra onde o tempo vai.
Trava o apply perigoso no pipeline. O mesmo motor roda offline como CLI, com Markdown, JSON ou SARIF e exit code por severidade.
Os GIFs são trechos dos vídeos do curso gratuito, narrados na minha voz, com as chamadas e as respostas reais do servidor. Os JSON completos estão em docs/examples.
Conecte em 30 segundos
Sem chave, sem cadastro:
# Claude Code
claude mcp add --transport http moretes-architect https://mcp.moretes.com/mcp
# Codex
codex mcp add moretes-architect --url https://mcp.moretes.com/mcp
# Gemini CLI
gemini mcp add --transport http moretes-architect https://mcp.moretes.com/mcp
Kiro (.kiro/settings/mcp.json), Cursor (.cursor/mcp.json) e Amazon Q (mcp.json):
{
"mcpServers": {
"moretes-architect": {
"url": "https://mcp.moretes.com/mcp",
"autoApprove": []
}
}
}
VS Code (.vscode/mcp.json):
{
"servers": {
"moretes-architect": { "type": "http", "url": "https://mcp.moretes.com/mcp" }
}
}
Claude Desktop e qualquer cliente stdio, depois de rodar local:
{ "mcpServers": { "moretes-architect": { "command": "node", "args": ["/CAMINHO/ABSOLUTO/dist/stdio.js"] } } }
Passo a passo de cada cliente, verificação e erros comuns: docs/clients.md.
Cota pública: 300 requisições por dia por cliente e 3.000 no total; acima disso, 429. O mesmo servidor responde em https://fernando.moretes.com/api/mcp, mas esse endereço passa pelo site e todos os seus usuários dividem uma única cota diária; use a URL direta para ter a sua. Para volume ou entradas privadas, rode local.
Depois de conectar, peça ao agente:
"Use o Moretes Architect. Preciso de uma API de pedidos para um marketplace, 300 pedidos por minuto no pico. Pergunte o que falta antes de sugerir, convoque os arquitetos de solução, segurança e FinOps, compare Lambda e ECS, desenhe o C4 e registre a decisão em um ADR."
O que ele faz
| Grupo | Ferramentas | Para quê |
|---|
| Personas e código | architect_panel, code_review_architecture, dependency_manifest_review | Convocar arquitetos de solução, enterprise, negócio, dados, infraestrutura, software, IA, segurança, governança e FinOps; revisar código e manifestos de dependência |
| Arquitetura e decisões | requirements_check, architecture_pattern, service_compare, decision_record, well_architected_review, threat_model, failure_rehearsal, capacity_plan, cost_model, slo_budget, migration_plan, architecture_diagram, implementation_plan, agent_tool_contract | Do requisito ao ADR, com os seis pilares, STRIDE, capacidade, custo datado e SLO |
| Design: diagramas, dados, contratos | c4_model, sequence_diagram, service_equivalents, data_classification, openapi_review, event_contract | C4 e sequência em Mermaid validados; equivalência AWS, Azure, GCP, OCI e open source em 43 capacidades; LGPD, GDPR e PCI como ponteiros; OpenAPI; contrato CloudEvents |
| Confiabilidade, operação e FinOps | latency_budget, queue_sizing, dr_strategy, retry_policy, storage_growth, finops_unit_economics, postmortem, runbook | Orçamento de latência, Erlang C, tier de DR por RTO/RPO, backoff com jitter, crescimento de armazenamento, custo por unidade, postmortem e runbook |
| Agentes de IA e segurança de MCP | agent_eval_plan, prompt_injection_checklist, rag_pipeline_plan, mcp_server_review, mcp_config_review | Plano de avaliação, controles contra injeção, RAG com autorização antes do top-k, revisão de outros servidores MCP e da configuração do seu cliente |
| Revisão de IaC | iam_policy_review, , , |
iam_policy_review lê política IAM da AWS, role definition do Azure e bindings do Google Cloud (provider). Toda ferramenta de cálculo e revisão publica outputSchema, e o cliente valida a saída.
Mais 20 prompts (10 fluxos e um architect_<papel> por persona), 18 resources (moretes://guide, moretes://boundaries, moretes://tools, moretes://personas/<id>, moretes://skills/<id>) e, só no modo local, 5 ferramentas opcionais de conta AWS e federação com os servidores oficiais.
Guia de cada ferramenta: docs/tools-guide.md · Schemas: docs/tools.md · Saídas reais: docs/examples · Personas: docs/personas.md
Saída real: um C4 desenhado pelo c4_model
Entrada: pessoas, sistemas e relações explícitas. Saída: Mermaid validado (id duplicado, aresta solta e rótulo com sintaxe perigosa são recusados). O GitHub renderiza abaixo exatamente o que a ferramenta devolveu em docs/examples/c4_model.json:
flowchart TB
buyer(["Buyer<br/>Places and tracks orders"])
subgraph system_Orders_platform["Orders platform"]
web["Storefront [Next.js]"]
api["Orders API [Node.js on Fargate]"]
db["Orders DB [PostgreSQL]"]
bus["Order events [EventBridge]"]
end
psp[["Payment provider [REST + webhooks]"]]
buyer -->|"uses"| web
web -->|"calls (HTTPS/JSON)"| api
api -->|"reads and writes"| db
api -->|"authorizes payment"| psp
psp -->|"webhook: payment captured"| api
api -->|"publishes OrderPlaced"| bus
classDef person fill:#1f3b63,stroke:#5b9bd5,color:#fff
class buyer person
classDef external fill:#4a4a4a,stroke:#9a9a9a,color:#fff
class psp external
Saída real: revisando um servidor MCP envenenado
mcp_server_review recebe o tools/list de outro servidor e procura texto de instrução escondido na descrição, parâmetros perigosos, anotação mentirosa e nomes duplicados. Contra o servidor de exemplo em docs/examples/mcp_server_review.json:
{
"summary": { "high": 5, "medium": 1, "info": 0 },
"verdict": "Do not auto-approve; review each high finding with the server author or pin to an allowlist",
"findings": [
{ "severity": "high", "target": "read_file", "message": "Description contains instruction-like text (references local secret files); tool-poisoning indicator." },
{ "severity": "high", "target": "read_file", "message": "Parameters that typically carry commands, raw queries, URLs or paths: path. Require an allowlist and per-call approval." }
]
}
Por que existe
Os servidores MCP de nuvem são operacionais: executam na conta. Faltava a parte de antes: levantar requisitos, comparar com honestidade entre provedores, calcular em vez de chutar, revisar com evidências e registrar a decisão. Este projeto faz essa parte, no mesmo lugar onde o código nasce, sem custo de inferência no servidor e sem receber credenciais.
Três regras atravessam todas as ferramentas:
- Pergunta antes de assumir. Requisito que falta volta como pergunta, não como valor típico.
- Calcula com entrada auditável. Preço só com fonte e data; fórmula explícita na saída.
- Heurística é triagem. Controle marcado como atendido sem evidência volta como desconhecido; toda revisão diz o que não cobre.
No pipeline
git clone https://github.com/fernando-moretes/moretes-aws-architect-mcp.git
cd moretes-aws-architect-mcp && npm ci --ignore-scripts && npm run build
terraform show -json tfplan > plan.json
node dist/cli.js call terraform_plan_review --input plan.json --format sarif --fail-on high > review.sarif
# exit 0: ok · 1: achados no nível --fail-on ou acima · 2: erro de uso ou entrada
Roda offline e sem cota. O SARIF entra no code scanning do GitHub; o Markdown vai para o resumo do job. GitHub Actions, GitLab CI e pre-commit prontos em docs/pipelines.md.
Integrações
| Onde | Como |
|---|
| Claude Code (plugin + skill) | /plugin marketplace add fernando-moretes/moretes-aws-architect-mcp e /plugin install moretes-architect@moretes |
| Gemini CLI | gemini extensions install https://github.com/fernando-moretes/moretes-aws-architect-mcp |
| Qualquer agente com Agent Skills | npx skills add fernando-moretes/moretes-aws-architect-mcp |
| GitHub Actions | uses: fernando-moretes/[email protected] com tool, files, fail-on e sarif |
| pre-commit | hooks mcp-config-review, dependency-manifest-review, cloudformation-review, openapi-review, code-review-architecture |
| Docker | docker run -i --rm ghcr.io/fernando-moretes/moretes-aws-architect-mcp (stdio), ... http, ... cli check <ferramenta> <arquivo> |
Detalhes e exemplos: docs/integrations-clients.md.
Rodar local
npm ci --ignore-scripts && npm run build
npm start # MCP stdio (o protocolo usa o stdout; não é um chat)
npm run http # http://127.0.0.1:8787/mcp e a landing local
node dist/cli.js list
As ferramentas de conta AWS (identidade STS, recursos por tag, histórico de custo) e a federação com os servidores oficiais são opt-in por variável de ambiente e só existem no stdio: o HTTP público nunca as expõe. Detalhes em docs/clients.md e docs/integrations.md. O pacote está publicado no npm. Use npx --yes --package [email protected] moretes-architect list para o CLI ou npx --yes --package [email protected] moretes-aws-architect-mcp para stdio.
Tutorial em vídeo e curso grátis
Em fernando.moretes.com/mcp: conexão por cliente, um playground que chama o servidor de verdade, as ferramentas por grupo, as personas, troubleshooting e FAQ. O curso tem dez aulas, cada uma com vídeo, áudio e texto, quizzes e certificado:
| # | Aula |
|---|
| 01 | O que é MCP e o que é o Moretes Architect |
| 02 | Conectar em 30 segundos: Claude Code, Codex, Kiro, Cursor e VS Code |
| 03 | Da ideia à decisão: requisitos, painel de arquitetos e ADR |
| 04 | Desenhar e contratar: C4, sequência, eventos e OpenAPI |
| 05 | Números que defendem a decisão: capacidade, latência, filas e custo |
| 06 | Revisar com evidências: Well-Architected, ameaças, dados e IAM |
| 07 | IaC e código no pipeline: Terraform, CloudFormation, Kubernetes e o CLI |
| 08 | Operar e recuperar: DR, retries, ensaio de falha, runbook e postmortem |
| 09 | Agentes de IA em produção e segurança de MCP |
| 10 | Personas, fontes oficiais, modo local e como contribuir |
Privacidade e limites
- O servidor público processa a entrada em memória e registra só id da requisição, status e duração. Nunca argumentos, prompts ou resultados.
- Só duas famílias saem para a internet:
aws_knowledge_* (a consulta vai para o MCP oficial da AWS) e github_public_repository (api.github.com). Todo o resto é cálculo local.
- Contadores mensais em
/stats.json registram apenas nomes de ferramentas, sem argumentos, resultados ou identidade; não representam usuários únicos ou análises bem-sucedidas.
- A cota por cliente usa
sha256(dia + IP) com validade de dois dias; o IP bruto não é guardado.
- Não envie segredos, dados de clientes ou arquitetura confidencial ao endpoint público; para isso existe o modo local.
- Sem SLA. Serviço comunitário, mantido por uma pessoa, com orçamento alvo de US$ 30 por mês.
Tudo em PRIVACY.md e SECURITY.md.
Arquitetura
flowchart LR
C[Claude Code / Codex / Kiro / Cursor / VS Code] -->|Streamable HTTP| G[API Gateway: 5 rps, rajada 20]
G --> L[Lambda arm64: 48 ferramentas públicas]
L --> Q[DynamoDB: cota global e por cliente]
L --> K[AWS Knowledge MCP oficial]
L --> H[GitHub: metadados públicos]
C -->|stdio, opcional| S[MCP local]
S --> A[Credenciais do SDK + guarda de conta]
A --> R[3 ferramentas de conta, somente leitura]
A --> F[Servidores oficiais instalados + allowlist exata]
P[CLI moretes-architect] --> T[Mesmas ferramentas, offline]
A role da Lambda escreve e lê contadores somente na própria tabela DynamoDB e escreve nos próprios logs. Deploy por change set CloudFormation revisado. Design · Custos · Runbook · Evidências do deploy
Qualidade
npm run typecheck && npm test && npm run build && npm audit --omit=dev
npm run smoke -- https://mcp.moretes.com/mcp # consulta pública real
node scripts/examples.mjs # regenera docs/examples com as saídas reais
41 testes offline, 99% das linhas cobertas, cobrem protocolo, cálculos, revisões, isolamento entre público e local, limites de entrada e federação. CI em Node 22 e 24, CodeQL, Dependabot e SBOM CycloneDX a cada release. Cada saída documentada em docs/examples é um teste: se uma ferramenta mudar de comportamento, o CI acusa. docs/tools.lock.json guarda o hash do nome, da descrição e do schema de cada ferramenta, então qualquer mudança no que o modelo do cliente lê aparece no diff.
Contribua
Issues e PRs em português ou inglês. Use os templates: bug ou proposta de ferramenta (problema, entrada, saída esperada, limite). Uma ferramenta nova precisa de schema estrito, fronteira de dados externos explícita, limitações na saída e teste. Se você é AWS Community Builder, organiza User Group ou dá aula: o curso e os vídeos são livres para usar em sala.
Clientes · Ferramentas · Personas · Pipelines · FAQ · Troubleshooting · Glossário · Novidades · Workshop · Contribuir · Conduta · Roadmap · Changelog · Atribuições
Projeto independente. Não é um produto da AWS, nem revisão Well-Architected oficial, nem certificação de segurança, nem cotação de preço. AWS e outros nomes pertencem aos seus donos.
