AWS存储MCP服务器
一个模型上下文协议（MCP）服务器，通过Amazon Q CLI实现与AWS存储服务的自然语言交互。
免责声明
本项目按“原样”提供，不提供任何明示或暗示的保证。作者和贡献者不对使用本软件可能造成的任何损害或责任负责。
- 不是AWS官方产品：这是一个社区项目，没有得到亚马逊网络服务的正式支持。
- 使用风险自负：在执行操作之前，请先检查所有操作，特别是那些修改或删除资源的操作。
- 成本影响：使用AWS服务可能会给您的AWS帐户带来成本。您有责任监控和管理这些成本。
- 安全考虑：此工具需要AWS凭据才能运行。处理凭据时始终遵循安全最佳实践。
- 无责任：作者和贡献者对使用本软件造成的任何数据丢失、意外费用或其他损害不承担责任。
什么是MCP？
模型上下文协议（MCP）是一个开放协议，它规范了应用程序如何向大型语言模型（LLM）提供上下文。MCP支持Amazon Q等LLM与本地运行的MCP服务器之间的通信，这些服务器提供了额外的工具和功能。
为什么使用MCP？
- 自然语言接口：使用简单的英语而不是复杂的CLI命令与AWS服务交互
- 简化的工作流程：使用简单的查询执行复杂的操作，如“列出我的S3存储桶”
- 情境理解：MCP服务器为LLM提供特定于域的知识
- 扩展功能：在不重新训练模型的情况下为LLM添加新功能
- 本地执行：使用您的凭据在本地计算机上执行操作
这个项目做什么
此AWS Storage MCP服务器将Amazon Q连接到您的AWS存储服务，使您能够：
- 查询AWS存储资源 使用自然语言
- 执行操作 在AWS存储服务上，无需记住复杂的命令
- 获取信息 以对话的方式了解您的存储资源
- 管理多种存储服务 从单一界面
架构图
!
支持的AWS存储服务
- 亚马逊S3：任何类型数据的对象存储
- 块存储：EC2实例的块存储
- 亚马逊EFS：EC2实例的可扩展文件存储
- 亚马逊FSx：基于Windows Server构建的完全托管文件存储
- AWS存储网关：将本地环境与云存储连接起来的混合云存储
- 亚马逊S3冰川：低成本归档存储
- AWS Snow系列：用于数据迁移和边缘计算的物理设备
- AWS备份：集中备份服务
- Amazon S3对象Lambda：检索期间处理S3数据
- 亚马逊S3冰川深度档案：成本最低的归档存储类
先决条件
- Docker和Docker Compose
- AWS CLI已配置有效凭据
- 已安装Amazon Q CLI
快速开始
故障排除
如果您遇到问题：
- 检查Docker容器状态
docker ps | grep aws-storage- 查看容器日志
docker logs aws-storage-mcp-aws-storage-mcp-1- 直接测试API
curl -s -X POST -H "Content-Type: application/json" -d '{"tool_name": "list_aws_profiles", "parameters": {}}' http://localhost:8080/invoke- 验证AWS凭据
确保您的AWS凭据有效并具有必要的权限。
- 重新启动容器
docker compose restart项目结构
aws-storage-mcp/
├── README.md # This documentation
├── requirements.txt # Python dependencies
├── mcp-manifest.json # MCP server manifest
├── docker-compose.yml # Docker configuration
├── docker-compose.override.yml # Volume mapping for AWS credentials
├── Dockerfile # Docker build instructions
├── setup.sh # Environment setup script
├── start-docker.sh # Server startup script
└── src/ # Source code
├── server.py # MCP server implementation
└── services/ # AWS service modules
├── __init__.py
├── base.py # Base service class
├── s3.py # S3 operations
├── ebs.py # EBS operations
├── efs.py # EFS operations
└── ... # Other service modules文档
贡献
欢迎投稿！请阅读我们的 贡献指南 有关如何提交pull请求、报告问题和建议增强功能的详细信息。
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
安全说明
- 此MCP服务器使用您的AWS凭据运行
- 所有操作都是在您的权限下执行的
- 在生产环境中运行之前检查代码
- 考虑使用具有最小权限原则的IAM角色
