AWS Model Context Protocol (MCP) Server

基本能力

产品定位

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（推荐）

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

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/

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。