article
README
🚀 AWS MCP 服务器
AWS MCP 服务器基于 AWS 模型上下文协议 (MCP) 构建,它允许像 Claude 这样的 AI 助手与您的 AWS 环境进行交互。借助该服务器,您能够在对话中使用自然语言查询和管理 AWS 资源,堪称 Amazon Q 的优质替代方案。

🚀 快速开始
在使用 AWS MCP 服务器前,您需要完成一系列准备工作,包括安装必要的软件和配置 AWS 凭证。完成准备工作后,按照安装和使用步骤操作,即可让 AI 助手与您的 AWS 环境交互。
✨ 主要特性
- 🔍 支持使用自然语言查询和修改 AWS 资源,操作更便捷。
- ☁️ 支持多个 AWS 配置文件和单点登录 (SSO) 认证,满足多样化需求。
- 🌐 具备多区域支持能力,适应不同地区的使用场景。
- 🔐 采用安全的凭证处理方式,不将凭证暴露给外部服务,使用本地凭证保障安全。
- 🏃♂️ 可使用您的 AWS 凭证进行本地执行,确保操作的自主性。
📦 安装指南
先决条件
- Node.js
- Claude Desktop
- 本地配置的 AWS 凭证(
~/.aws/目录)
安装步骤
- 克隆仓库:
git clone https://github.com/RafalWilinski/aws-mcp
cd aws-mcp
- 安装依赖项:
pnpm install
# 或者
npm install
💻 使用示例
基础用法
- 打开 Claude 桌面应用程序,进入设置 -> 开发人员 -> 编辑配置。

- 将以下内容添加到您的
claude_desktop_config.json文件中:
{
"mcpServers": {
"aws": {
"command": "npm", // 或者 pnpm
"args": [
"--silent",
"--prefix",
"/Users/<YOUR USERNAME>/aws-mcp",
"start"
]
}
}
}
⚠️ 重要提示
请将
/Users/<YOUR USERNAME>/aws-mcp替换为您项目的实际路径。
- 重启 Claude 桌面应用程序。您应该看到如下界面:

- 开始使用,选择一个 AWS 配置文件或直接通过对话操作:
- "列出可用的 AWS 配置文件"
- "列出我账户中的所有 EC2 实例"
- "显示 S3 存储桶及其大小"
- "us-east-1 区域中有哪些已部署的 Lambda 函数?"
- "列出所有 ECS 集群及其服务"
高级用法
若要从源代码构建并使用,可在配置中添加以下内容:
{
"mcpServers": {
"aws": {
"command": "/Users/<USERNAME>/.nvm/versions/node/v20.10.0/bin/node",
"args": [
"<WORKSPACE_PATH>/aws-mcp/node_modules/tsx/dist/cli.mjs",
"<WORKSPACE_PATH>/aws-mcp/index.ts",
"--prefix",
"<WORKSPACE_PATH>/aws-mcp",
"start"
]
}
}
}
📚 详细文档
故障排除
查看日志:
tail -n 50 -f ~/Library/Logs/Claude/mcp-server-aws.log
# 或者
tail -n 50 -f ~/Library/Logs/Claude/mcp.log
开发中特性
- [ ] MFA 支持
- [ ] 防止过快刷新的 SSO 凭证缓存
微信扫一扫