金大哥 - aws-sage MCP 详情

article

README

🚀 AWS MCP

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

✨ 主要特性

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

🚀 快速开始

工作流程

MCP 工作流程

前提条件

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
……以及更多！

aws-sage