Aws Storage MCP

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存储服务，使您能够：

1. 查询AWS存储资源 使用自然语言
2. 执行操作 在AWS存储服务上，无需记住复杂的命令
3. 获取信息 以对话的方式了解您的存储资源
4. 管理多种存储服务 从单一界面

架构图


支持的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

快速开始

• 有关详细的安装说明，请参阅 安装指南.
• 有关详细的使用示例，请参阅 使用指南.
• 有关实际示例和演示，请参阅 示例指南.

故障排除

如果您遇到问题：

1. 检查Docker容器状态

   docker ps | grep aws-storage

1. 查看容器日志

   docker logs aws-storage-mcp-aws-storage-mcp-1

1. 直接测试API

   curl -s -X POST -H "Content-Type: application/json" -d '{"tool_name": "list_aws_profiles", "parameters": {}}' http://localhost:8080/invoke

1. 验证AWS凭据

确保您的AWS凭据有效并具有必要的权限。

1. 重新启动容器

   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角色