AWS MCP Setup

AWS MCP 服务器配置指南

适用场景

当你需要为 AI 智能体配置 AWS MCP 服务器以提供文档搜索和 API 调用能力时使用本技能。适用于设置 AWS MCP、配置 AWS 文档工具、排查 MCP 连接问题的场景，或当用户提及 aws-mcp、awsdocs、uvx 安装、MCP 服务器配置时触发。同时覆盖完整版 AWS MCP 服务器（带身份认证）与免认证的 AWS 文档 MCP 服务器两种方案。

概述

本指南帮助你为 AI 智能体配置 AWS MCP 工具。共有两种方案可选：

步骤 1：检查现有配置

配置前，先用以下任一方法确认 AWS MCP 工具是否已经可用：

方法 A：检查可用工具（推荐）

在你的智能体可用工具列表中查找以下工具名模式：

• mcp__aws-mcp__* 或 mcp__aws__* → 已配置完整版 AWS MCP 服务器
• mcp__*awsdocs*__aws___* → 已配置 AWS 文档 MCP

如何检查：运行 /mcp 命令列出所有当前激活的 MCP 服务器。

方法 B：检查配置文件

智能体工具采用分层配置（优先级：本地 → 项目 → 用户 → 企业）：

在这些文件中查找含有 aws-mcp、aws 或 awsdocs 键的 mcpServers：

# 检查项目配置
cat .mcp.json 2>/dev/null | grep -E '"(aws-mcp|aws|awsdocs)"'

# 检查用户配置
cat ~/.claude.json 2>/dev/null | grep -E '"(aws-mcp|aws|awsdocs)"'

# 或使用 Claude CLI
claude mcp list

若 AWS MCP 已经配置好，则无需重复配置。

步骤 2：选择配置方案

自动检测

运行以下命令判断应使用哪种方案：

# 检查 uvx（需 Python 3.10+）
which uvx || echo "uvx not available"

# 检查 AWS 凭证是否有效
aws sts get-caller-identity || echo "AWS credentials not configured"

方案 A：完整版 AWS MCP 服务器（推荐）

适用条件：uvx 可用 且 AWS 凭证有效

前置条件：

• Python 3.10+，并安装了 uv 包管理器
• 已配置 AWS 凭证（可通过 profile、环境变量或 IAM 角色）

必需的 IAM 权限：

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "aws-mcp:InvokeMCP",
      "aws-mcp:CallReadOnlyTool",
      "aws-mcp:CallReadWriteTool"
    ],
    "Resource": "*"
  }]
}

配置项（添加到你的 MCP 设置中）：

{
  "mcpServers": {
    "aws-mcp": {
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws@latest",
        "https://aws-mcp.us-east-1.api.aws/mcp",
        "--metadata", "AWS_REGION=us-west-2"
      ]
    }
  }
}

凭证配置选项：

1. AWS Profile（推荐用于开发场景）：

   "args": [
     "mcp-proxy-for-aws@latest",
     "https://aws-mcp.us-east-1.api.aws/mcp",
     "--profile", "my-profile",
     "--metadata", "AWS_REGION=us-west-2"
   ]
   

2. 环境变量：

   "env": {
     "AWS_ACCESS_KEY_ID": "...",
     "AWS_SECRET_ACCESS_KEY": "...",
     "AWS_REGION": "us-west-2"
   }
   

3. IAM 角色（适用于 EC2/ECS/Lambda）：无需额外配置，会自动使用实例元数据凭证

附加选项：

• --region <region>：覆盖 AWS 区域
• --read-only：限制为只读工具
• --log-level <level>：设置日志级别（debug、info、warning、error）

参考链接：https://github.com/aws/mcp-proxy-for-aws

方案 B：AWS 文档 MCP 服务器（免认证）

适用条件：

• 没有 Python/uvx 环境
• 没有 AWS 凭证
• 仅需要文档搜索（不需要执行 API）

配置项：

{
  "mcpServers": {
    "awsdocs": {
      "type": "http",
      "url": "https://knowledge-mcp.global.api.aws"
    }
  }
}

步骤 3：验证

配置完成后，请验证工具是否可用：

完整版 AWS MCP：

• 查找工具：mcp__aws-mcp__aws___search_documentation、mcp__aws-mcp__aws___call_aws

文档 MCP：

• 查找工具：mcp__awsdocs__aws___search_documentation、mcp__awsdocs__aws___read_documentation

故障排除

使用限制

• 仅在任务需求与上游来源和本地项目上下文明确匹配时使用本技能。
• 在应用任何变更前，请先验证命令、生成的代码、依赖、凭证以及外部服务行为。
• 不要将示例直接当作特定环境下的测试、安全审查或破坏性/高成本操作的用户授权依据来使用。