aws-mcp

🚀 AWS MCP - 模型上下文协议服务器

AWS MCP是一个模型上下文协议服务器，允许AI助手如Claude与您的AWS环境交互。借助它，您可以在对话中使用自然语言查询和管理AWS资源，堪称更好的Amazon Q替代方案。

🚀 快速开始

先决条件

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

安装

1. 克隆仓库：

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

2. 安装依赖项：

pnpm install
# 或者
npm install

使用方法

1. 打开Claude桌面应用程序，进入设置 -> 开发者 -> 编辑配置。
2. 在您的 claude_desktop_config.json 中添加以下条目：

{
  "mcpServers": {
    "aws": {
      "command": "npm", // 或者 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
# 或者
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

✨ 主要特性

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

📚 详细文档

开发中功能

• [ ] MFA 支持
• [ ] 防止过于频繁刷新的SSO凭证缓存