🚀 AWS MCP
AWS MCP 是一个 模型上下文协议（MCP） 服务器，它能让像 Claude 这样的 AI 助手与你的 AWS 环境进行交互。借助它，你可以在对话中通过自然语言查询和管理 AWS 资源，可将其视为 Amazon Q 的优秀替代方案。
✨ 主要特性
- 支持使用自然语言查询和修改 AWS 资源。
- 支持多个 AWS 配置文件。
- 支持多区域。
- 可使用你的 AWS 凭证在本地执行操作。
🚀 快速开始
工作流程
前提条件
- Python
- Claude 桌面应用
- 本地配置好 AWS 凭证（
~/.aws/目录）
📦 安装指南
- 克隆仓库：
git clone https://github.com/yourusername/aws-mcp
cd aws-mcp
- 安装 Python MCP 服务器：
pip install -e .
💻 使用示例
作为命令行界面使用
AWS MCP 也可以作为命令行界面使用：
# 显示可用命令
python -m aws_mcp --help
# 列出可用的 AWS 配置文件
python -m aws_mcp list-credentials
# 选择一个 AWS 配置文件
python -m aws_mcp select-profile myprofile
# 运行 AWS 操作
python -m aws_mcp run-aws-code "list all S3 buckets"
# 使用漂亮的格式以获得更易读的输出
python -m aws_mcp --format pretty list-credentials
⚠️ 重要提示：如有需要，请将 python 替换为你的 Python 可执行文件的路径。
与 Claude 桌面应用配合使用
- 打开 Claude 桌面应用，转到“设置” -> “开发者” -> “编辑配置”。
- 在你的
claude_desktop_config.json中添加以下条目：
{
"mcpServers": {
"aws-mcp": {
"command": "/path/to/your/python",
"args": ["/path/to/your/aws-mcp/run_aws_mcp.py"]
}
}
}
⚠️ 重要提示：请将 /path/to/your/python 替换为你在终端中运行 which python 的结果。
⚠️ 重要提示：请将 /path/to/your/aws-mcp/run_aws_mcp.py 替换为 run_aws_mcp.py 文件的实际路径。
3. 重启 Claude 桌面应用，确保没有错误。
4. 可以先选择一个 AWS 配置文件，或者直接通过提问来执行操作，例如：
- “列出可用的 AWS 配置文件”
- “列出我账户中的所有 EC2 实例”
- “显示我的 S3 存储桶及其大小”
- “美国东部 1 区部署了哪些 Lambda 函数？”
- “列出所有 ECS 集群及其服务”
故障排除
若要查看日志，请执行以下命令：
tail -n 50 -f ~/Library/Logs/Claude/mcp-server-aws-mcp.log
# 或者
tail -n 50 -f ~/Library/Logs/Claude/mcp.log
开发中的特性
- [ ] 支持多因素认证（MFA）
- [ ] 缓存 SSO 凭证，避免频繁刷新
联系我们
如果你对 AWS MCP 有任何疑问、建议或想参与讨论，请：
- 在 GitHub 上创建一个问题
- 发送电子邮件至：arun.sanna@outlook.com
有关如何为该项目做出贡献的信息，请查看 CONTRIBUTING.md。
📚 详细文档
AWS 集成
AWS MCP 支持使用 boto3 动态执行 AWS 操作，它能够：
- 解析自然语言或类似代码的请求，以确定 AWS 服务和操作。
- 自动执行相应的
boto3命令。 - 尽可能将结果格式化为易读的表格。
- 优雅地处理错误。
支持的服务
解析器可以动态识别并处理通过 boto3 可用的所有 AWS 服务，包括：
- S3
- EC2
- Lambda
- IAM
- DynamoDB
- RDS
- CloudFormation
- CloudWatch
- SNS
- SQS
- KMS
- Secrets Manager
- SSM
- Route53
- CloudFront
- Elastic Beanstalk
- API Gateway
- ECS
- STS
- Cognito
- CodeBuild
- CodeCommit
- CodePipeline
- Organizations
- GuardDuty
- ……以及更多！