aws-mcp-setup

用途

本技能用于为 AI 智能体配置 AWS MCP 服务器，使其能够搜索 AWS 文档并（在完整模式下）执行 AWS API 调用。适用于需要让智能体访问 AWS 文档或操作 AWS 资源的场景。

两种配置方案

方案	要求	能力
完整 AWS MCP 服务器	Python 3.10+、uvx、AWS 凭证	执行 AWS API 调用 + 文档搜索
AWS 文档 MCP	无	仅文档搜索

使用方式

第一步：检查现有配置

可通过两种方法检查 AWS MCP 工具是否已可用：

方法 A（推荐）：在智能体的可用工具中查找以下名称模式：

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

运行 /mcp 命令可列出所有活动的 MCP 服务器。

方法 B：检查配置文件。智能体工具采用分层配置（优先级：local → project → user → enterprise）：

范围	文件位置	用途
Local	`.claude.json`（项目内）	个人/实验性
Project	`.mcp.json`（项目根目录）	团队共享
User	`~/.claude.json`	跨项目个人使用
Enterprise	系统管理目录	组织范围

检查这些文件中是否包含 aws-mcp、aws 或 awsdocs 键：

# 检查项目配置
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

若已配置，则无需进一步设置。

第二步：选择配置方式

自动检测：

# 检查 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"
      ]
    }
  }
}

凭证配置选项：

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

环境变量：

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

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

第三步：验证

配置后验证工具是否可用：

完整 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

故障排查

问题	原因	解决方案
uvx: command not found	未安装 uv	使用 `pip install uv` 安装，或改用方案 B
AccessDenied 错误	缺少 IAM 权限	在 IAM 策略中添加 `aws-mcp:*` 权限
InvalidSignatureException	凭证问题	检查 `aws sts get-caller-identity`
工具未出现	MCP 未启动	配置更改后重启智能体

适用场景

需要让 AI 智能体查询 AWS 文档
需要让 AI 智能体执行 AWS API 调用（完整模式）
在团队或组织内统一配置 AWS MCP

限制

完整模式需要 Python 3.10+、uvx 及有效 AWS 凭证
文档模式仅支持文档搜索，无法执行 API 调用
具体收费、价格等信息暂未提供