AWS MCP

AWS MCP

一个 模型上下文协议（MCP） 服务，可让 Claude 等 AI 助手与您的 AWS 环境交互。这样，您就可以在对话中使用自然语言查询和管理 AWS 资源。可以把它看作更好的 Amazon Q 替代品。

功能

• 🔍 使用自然语言查询和修改 AWS 资源
• ☁️ 支持多个 AWS 配置文件和 SSO 身份验证
• 🌐 支持多区域
• 🔐 安全处理凭据（不会向外部服务暴露任何凭据，使用您的本地凭据）
• 🏃‍♂️ 使用您的 AWS 凭据在本地执行

前提条件

• Node.js
• Claude Desktop
• 已在本地配置 AWS 凭据（~/.aws/ 目录）

安装

1. 克隆此仓库：

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

2. 安装依赖：

pnpm install
# or
npm install

使用方法

1. 打开 Claude 桌面应用，前往 Settings -> Developer -> Edit Config

2. 将以下条目添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "aws": {
      "command": "npm", // OR pnpm
      "args": [
        "--silent",
        "--prefix",
        "/Users/<YOUR USERNAME>/aws-mcp",
        "start"
      ]
    }
  }
}

重要提示：将 /Users/<YOUR USERNAME>/aws-mcp 替换为项目目录的实际路径。

3. 重启 Claude 桌面应用。您应该会看到：

4. 选择一个 AWS 配置文件，或直接通过提问开始操作：
   • “列出可用的 AWS 配置文件”
   • “列出我账户中的所有 EC2 实例”
   • “显示 S3 存储桶及其大小”
   • “us-east-1 中部署了哪些 Lambda 函数？”
   • “列出所有 ECS 集群及其服务”

与 nvm 配合使用

先从源代码构建，然后添加以下配置：

{
  "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
# or
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

开发中的功能

• 支持 MFA
• 缓存 SSO 凭据，避免过于频繁地刷新