使用说明
AWS安全MCP服务器
用于AWS安全管理的综合模型上下文协议(MCP)服务器,在21个AWS服务中使用80多种工具。
什么是MCP?
模型上下文协议使AI客户端能够与外部工具进行交互。这在人工智能助手和您的AWS基础设施之间建立了一座桥梁,用于自然语言安全管理。
架构:
AI Client (VS Code/Amazon Q) ←→ MCP Protocol ←→ AWS Security Server ←→ AWS APIs
优点:
- ✅ 自然语言:用简单的英语问安全问题
- ✅ 实时数据:直接连接到您的AWS帐户
- ✅ 80+安全工具 跨21个AWS服务
- ✅ 性能优化:VS Code/亚马逊Q的快速执行
支持服务列表
核心安全: IAM、EC2安全、S3安全、KMS、安全中心、GuardDuty、CloudTrail、配置
高级安全: 访问分析器、检查器、Macie、网络防火墙、秘密管理器、Shield、WAF、ACM、审计管理器、CloudWatch、身份中心、验证访问、VPC Lattice
安全审计: 全面的审计报告、快速的安全扫描、风险评估
主要特点
安全能力
- 🔍 非活动用户检测 (90天以上)
- 🔑 访问密钥旋转监控 (180天以上)
- 🚫 特权策略检测
- 🔒 MFA合规审计
- 🚪 开放安全组检测
- 📦 S3 Bucket安全分析
- 📊 安全态势评分
技术特性
- 异步/等待实现
- 全面的错误处理
- 类型安全的Pydantic模型
- JSON配置
- 生产就绪架构
快速开始
安装
git clone https://github.com/aquavis12/aws-security-mcp-server.git
cd aws-security-mcp-server
pip install -e .
python -m aws_security_mcp
先决条件
- Python 3.9+
- 已配置AWS凭据
- pip包管理器
工具类别(80+工具)
🔍 身份和访问管理(15个工具)
- 用户/角色管理、非活动用户检测、访问密钥轮换、MFA合规性、特权策略
🛡️ 网络安全(11个工具)
- 安全组、网络ACL、网络防火墙、VPC格子
🔐 数据保护(9个工具)
- S3存储桶安全、KMS密钥管理、秘密管理器、ACM证书
📊 监控与检测(15个工具)
- 警卫、安全中心、CloudTrail、检查员、Macie
🛠️ 基础设施安全(8个工具)
- EC2实例、密钥对、屏蔽DDoS、WAF
📈 合规与审计(22+工具)
- 安全审计报告、快速扫描、配置合规性、审计管理器
查询示例
- “显示过去90天内不活跃的IAM用户”
- “列出允许从0.0.0.0/0访问的安全组”
- “查找未加密的S3存储桶”
- “生成全面的安全审计报告”
- “运行快速安全扫描以查找即时问题”
- “显示未启用MFA的用户”
- “审核访问密钥在6个月内未轮换”
VS代码集成
增添 settings.json:
{
"mcp.servers": {
"aws-security": {
"command": "python",
"args": ["-m", "aws_security_mcp"],
"env": {
"AWS_REGION": "us-east-1",
"AWS_PROFILE": "default"
}
}
}
}
配置
创建 mcp-config.json:
{
"aws": {
"region": "us-east-1",
"profile": "default"
},
"logging": {
"level": "INFO"
},
"services": {
"enabled": [
"iam", "kms", "guardduty", "securityhub", "config",
"accessanalyzer", "cloudtrail", "inspector", "macie",
"networkfirewall", "secretsmanager", "shield", "waf",
"acm", "auditmanager", "cloudwatch", "ec2_security",
"identitycenter", "verifiedaccess", "vpclattice", "security_audit"
]
}
}
项目结构
aws-security-mcp-server/
├── src/aws_security_mcp/
│ ├── services/ # 21 AWS service implementations
│ ├── models/ # Pydantic data models
│ ├── utils/ # AWS helper utilities
│ └── server.py # Main MCP server
├── config/ # Configuration files
├── TOOLS.md # Complete tools reference
└── pyproject.toml # Package configuration
演出
- 即时响应:亚秒级响应时间
- 异步架构:高效的并发AWS API调用
- 智能缓存:减少多余的API调用
- 差错恢复:全面的错误处理
文档
- TOOLS.md -完整的工具参考
- SETUP_GUIDE.md -详细的设置指南
config/-示例配置
许可证
MIT许可证-有关详细信息,请参阅许可证文件