AWS MCP Quick Start Guide

概述

AWS MCP 是一个模型上下文协议服务器，允许 Claude 通过自然语言与 AWS 环境交互，可视为 Amazon Q 的增强替代品。

先决条件

• Node.js
• Claude Desktop
• 本地配置的 AWS 凭证 (~/.aws/ 目录)

安装步骤

1. 克隆并安装

   git clone https://github.com/RafalWilinski/aws-mcp
   cd aws-mcp
   pnpm install  # 或 npm install
   

2. 配置 Claude

   • 打开 Claude 桌面应用，进入：设置 → 开发者 → 编辑配置
   • 添加以下配置到 claude_desktop_config.json：

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

   注意：替换路径为实际项目路径

3. 重启 Claude 应用

   成功连接后，会显示 MCP 连接状态指示器。

使用方法

直接用自然语言询问 Claude：

• "列出所有可用的 AWS 配置文件"
• "显示我账户中的所有 EC2 实例"
• "显示带有大小的 S3 存储桶"
• "us-east-1 中部署了哪些 Lambda 函数？"

使用 NVM

如果使用 nvm 管理 Node 版本，请使用以下配置：

{
  "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