How skmahe1077/aws-wa-mcp-server works
AWS Well-Architected MCP Server exposes read-only account scans through an MCP interface. A user selects a pillar scan or an account-wide scan; the server resolves the AWS session and region, runs pillar checks against AWS, and returns findings, severity-based health scores, skipped checks, compliance mappings, and audit metadata. Six distinct pillar modules preserve the product’s domain coverage; shared scan primitives provide the internal result, scoring, and compliance layer. The excerpts show the server, shared primitives, and some pillar checks; other pillar capabilities are documented in the README, so their internal details are not inferred.
Main entry points: server.py MCP scan server · __init__.py Pillar registry · common.py Scan primitives · cost_optimization.py Cost optimization
Components 11
MCP interface
- MCP scan server
aws_wa_mcp/server.py - Pillar registry
aws_wa_mcp/pillars/__init__.py
Pillar scanners
- Cost optimization
aws_wa_mcp/pillars/cost_optimization.py - Reliability
aws_wa_mcp/pillars/reliability.py - Performance efficiency
aws_wa_mcp/pillars/performance_efficiency.py - Operational excellence
aws_wa_mcp/pillars/operational_excellence.py - Security
aws_wa_mcp/pillars/security.py - Sustainability
aws_wa_mcp/pillars/sustainability.py
Scan analysis
- Scan primitives
aws_wa_mcp/pillars/common.py
External systems
- AWS account APIs
Other components
- Assistant user
Connections 28
- Assistant user → MCP scan server: requests scans
README.md - MCP scan server → Pillar registry: loads tools
aws_wa_mcp/server.py - Pillar registry → Cost optimization: registers scanner
aws_wa_mcp/pillars/__init__.py - Pillar registry → Reliability: registers scanner
aws_wa_mcp/pillars/__init__.py - Pillar registry → Performance efficiency: registers scanner
aws_wa_mcp/pillars/__init__.py - Pillar registry → Operational excellence: registers scanner
aws_wa_mcp/pillars/__init__.py - Pillar registry → Security: registers scanner
aws_wa_mcp/pillars/__init__.py - Pillar registry → Sustainability: registers scanner
aws_wa_mcp/pillars/__init__.py - MCP scan server → Cost optimization: runs selected scan
README.md - MCP scan server → Reliability: runs selected scan
README.md - MCP scan server → Performance efficiency: runs selected scan
README.md - MCP scan server → Operational excellence: runs selected scan
README.md - MCP scan server → Security: runs selected scan
README.md - MCP scan server → Sustainability: runs selected scan
README.md - Cost optimization → Scan primitives: uses shared checks
aws_wa_mcp/pillars/cost_optimization.py - Reliability → Scan primitives: uses shared checks
aws_wa_mcp/pillars/reliability.py - Performance efficiency → Scan primitives: uses shared checks
aws_wa_mcp/pillars/performance_efficiency.py - Operational excellence → Scan primitives: uses shared checks
aws_wa_mcp/pillars/operational_excellence.py - Security → Scan primitives: uses shared checks
aws_wa_mcp/pillars/security.py - Sustainability → Scan primitives: uses shared checks
aws_wa_mcp/pillars/sustainability.py - MCP scan server → Scan primitives: builds scan response
aws_wa_mcp/server.py - MCP scan server → AWS account APIs: reads caller identity
aws_wa_mcp/server.py - Cost optimization → AWS account APIs: reads account resources
README.md - Reliability → AWS account APIs: reads account resources
README.md - Performance efficiency → AWS account APIs: reads account resources
README.md - Operational excellence → AWS account APIs: reads account resources
README.md - Security → AWS account APIs: reads account resources
aws_wa_mcp/pillars/security.py - Sustainability → AWS account APIs: reads account resources
README.md