返回 MCP 目录
public公开dns本地运行

AWS

AWS MCP是一个基于Model Context Protocol的服务,允许通过自然语言查询和管理AWS资源,类似于Amazon Q的替代方案。

article

README

🚀 AWS MCP 服务器

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

AWS MCP

🚀 快速开始

在使用 AWS MCP 服务器前,您需要完成一系列准备工作,包括安装必要的软件和配置 AWS 凭证。完成准备工作后,按照安装和使用步骤操作,即可让 AI 助手与您的 AWS 环境交互。

✨ 主要特性

  • 🔍 支持使用自然语言查询和修改 AWS 资源,操作更便捷。
  • ☁️ 支持多个 AWS 配置文件和单点登录 (SSO) 认证,满足多样化需求。
  • 🌐 具备多区域支持能力,适应不同地区的使用场景。
  • 🔐 采用安全的凭证处理方式,不将凭证暴露给外部服务,使用本地凭证保障安全。
  • 🏃♂️ 可使用您的 AWS 凭证进行本地执行,确保操作的自主性。

📦 安装指南

先决条件

安装步骤

  1. 克隆仓库:
git clone https://github.com/RafalWilinski/aws-mcp
cd aws-mcp
  1. 安装依赖项:
pnpm install
# 或者
npm install

💻 使用示例

基础用法

  1. 打开 Claude 桌面应用程序,进入设置 -> 开发人员 -> 编辑配置。 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 替换为您项目的实际路径。

  1. 重启 Claude 桌面应用程序。您应该看到如下界面: Claude MCP 连接状态
  2. 开始使用,选择一个 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 凭证缓存

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端