saulpatinojr/proj-cloud_architect_sidekick_mcp

---

What is this?

An enterprise-ready remote Model Context Protocol server that lets Claude (Claude Code, Claude.ai, Claude Desktop, or any MCP client) work with Architectural Decision Records (ADRs) as first-class, verifiable artifacts:

• Record decisions in MADR style with structured, testable claims; search, version, supersede and archive them.
• Ingest evidence (manifests, IaC, config, code) through a fast direct-to-Blob upload with quarantine, hashing and content-safety scanning.
• Detect technologies deterministically from .csproj, package.json, requirements, Dockerfiles, Bicep, Terraform, Kubernetes and CI files.
• Detect drift between accepted decisions and what the code and infrastructure actually do.
• Detect contradictions between decisions, with scope-aware false-positive guards.
• Review safety of proposed decisions (security, availability, data loss, privacy, compliance, lock-in, cost, EOL, operability, rollback, blast radius).
• Remember tool calls, decisions and human feedback per tenant and workspace with explainable retrieval.

And one guarantee above all: the server never changes a human decision on its own. Analyzers write only to system-managed observations; every suggested edit is a proposal a human approves.

How it works

flowchart LR
  C[Claude / MCP client] -->|HTTPS JSON-RPCStreamable HTTP| E[Azure FunctionsMCP extension]
  E --> P[Pipeline: auth · tenant · validationidempotency · audit · memory]
  P --> S[ADR services & deterministic analyzers]