基本能力
产品定位
AWS MCP Server 是一个连接AI助手与AWS CLI的中间件服务，旨在通过MCP协议使AI助手能够直接执行AWS CLI命令并获取格式化结果。
核心功能
- AWS CLI文档检索：获取AWS服务和命令的详细帮助信息。
- AWS CLI命令执行：执行AWS CLI命令并返回适合AI消费的格式化结果。
- Unix管道支持：支持使用标准Unix管道和工具过滤和转换AWS CLI输出。
- 预定义提示模板：提供常见AWS任务的最佳实践模板。
- Docker集成：支持通过容器化简单部署，支持多架构（AMD64/x86_64和ARM64）。
- AWS认证：利用主机上的现有AWS凭证。
适用场景
- 开发者通过AI助手自动化AWS资源管理。
- 需要快速获取AWS CLI文档和执行命令的场景。
- 使用AI助手进行AWS资源的安全审计、成本优化等任务。
工具列表
- Docker：用于容器化部署，支持多架构。
- AWS CLI：用于执行AWS命令。
- Python 3.13+：用于非Docker环境下的运行。
常见问题解答
- 认证问题：确保AWS凭证正确配置。
- 连接错误：验证服务器是否运行以及AI助手的连接设置是否正确。
- 权限错误：检查AWS凭证是否具有必要权限。
- 超时错误：对于长时间运行的命令，增加
AWS_MCP_TIMEOUT环境变量。
使用教程
使用依赖
- Docker（推荐）或Python 3.13+（及本地安装的AWS CLI）。
- 已配置的AWS凭证。
安装教程
使用Docker（推荐）
bash
git clone https://github.com/alexei-led/aws-mcp-server.git
cd aws-mcp-server
docker compose -f deploy/docker/docker-compose.yml up -d
使用Python
bash
git clone https://github.com/alexei-led/aws-mcp-server.git
cd aws-mcp-server
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -e .
python -m aws_mcp_server
调试方式
- 运行单元测试：
pytest -k "not integration" - 运行集成测试：
pytest --run-integration -m integration - 检查覆盖率：
pytest -k "not integration" --cov-report=html - 运行linting：
ruff check src/ tests/ - 运行格式化：
ruff format src/ tests/
