How aws/tools-for-devops-agent works
This repository is a toolkit for extending AWS DevOps Agent with operational knowledge, configured agents, data-retrieval tools, and IAM templates. The documented user workflow is to deploy skills and agents to an Agent Space, then use them during incident investigation; MCP servers provide access to supporting operational data. The graph represents the repository’s major product branches and selected MCP servers visible in the tree. Source excerpts are partial, so internal wiring beyond the sampled DNS, database, EKS, and ECS implementations is not inferred.
Main entry points: mcp MCP servers · skills Skills catalog · custom-agents Custom agents · ecs-instance-log-mcp ECS log analysis
Components 19
Investigation knowledge
- Skills catalog
skills - Health events
skills/aws-health-events - DNS investigation
skills/aws-vpc-dns-investigation - Support cases
skills/support-cases
Agent workflows
- Custom agents
custom-agents - Health report
custom-agents/aws-health-report - Operation review
custom-agents/aws-operation-review
Operational MCP tools
- MCP servers
mcp - EKS diagnostics
mcp/aws-eks-node-diagnostics-mcp - ECS log analysis
mcp/ecs-instance-log-mcp - VPC DNS diagnostics
mcp/aws-vpc-dns-diagnostics-mcp - Aurora diagnostics
mcp/rds-aidba - DNS simulation model
mcp/aws-vpc-dns-diagnostics-mcp/src/dns_model.py - ECS analysis handler
mcp/ecs-instance-log-mcp/src/lambda/ecs-log-automation.py
Permissions
- Skill IAM policies
cloudformation/devops-agent-skill-policies.yaml
Other components
- Operator
- AWS DevOps Agent
- AWS operational services
- AWS IAM
Connections 20
- Operator → AWS DevOps Agent: starts investigation
- AWS DevOps Agent → Skills catalog: uses knowledge
- AWS DevOps Agent → Custom agents: runs workflows
- AWS DevOps Agent → MCP servers: retrieves data
- Skills catalog → Health events: includes
- Skills catalog → DNS investigation: includes
- Skills catalog → Support cases: includes
- Custom agents → Health report: includes
- Custom agents → Operation review: includes
- MCP servers → EKS diagnostics: includes
- MCP servers → ECS log analysis: includes
- MCP servers → VPC DNS diagnostics: includes
- MCP servers → Aurora diagnostics: includes
- VPC DNS diagnostics → DNS simulation model: uses model
- ECS log analysis → ECS analysis handler: handles requests
- EKS diagnostics → AWS operational services: collects diagnostics
- ECS log analysis → AWS operational services: retrieves logs
- VPC DNS diagnostics → AWS operational services: reads DNS config
- Aurora diagnostics → AWS operational services: reads database health
- Skill IAM policies → AWS IAM: provisions permissions