Aws Sage

🚀 AWS MCP

AWS MCP 是一个 模型上下文协议（MCP） 服务器，它能让像 Claude 这样的 AI 助手与你的 AWS 环境进行交互。借助它，你可以在对话中通过自然语言查询和管理 AWS 资源，可将其视为 Amazon Q 的优秀替代方案。

✨ 主要特性

• 支持使用自然语言查询和修改 AWS 资源。
• 支持多个 AWS 配置文件。
• 支持多区域。
• 可使用你的 AWS 凭证在本地执行操作。

🚀 快速开始

工作流程

前提条件

• Python
• Claude 桌面应用
• 本地配置好 AWS 凭证（~/.aws/ 目录）

📦 安装指南

1. 克隆仓库：

git clone https://github.com/yourusername/aws-mcp
cd aws-mcp

2. 安装 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 桌面应用配合使用

1. 打开 Claude 桌面应用，转到“设置” -> “开发者” -> “编辑配置”。
2. 在你的 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 操作，它能够：

1. 解析自然语言或类似代码的请求，以确定 AWS 服务和操作。
2. 自动执行相应的 boto3 命令。
3. 尽可能将结果格式化为易读的表格。
4. 优雅地处理错误。

支持的服务

解析器可以动态识别并处理通过 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
• ……以及更多！