AWS

🚀 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/ 目录）

安装步骤

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 集群及其服务"

高级用法

若要从源代码构建并使用，可在配置中添加以下内容：

{
  "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 凭证缓存