aws-mcp-setup

AWS MCP 服务配置指南

概述

本指南将帮助你为 AI Agent 配置 AWS MCP 工具。你可以选择以下两种方式：

选项	要求	功能
完整 AWS MCP 服务	Python 3.10+、uvx、AWS 凭证	执行 AWS API 调用 + 搜索文档
AWS Documentation MCP	无	仅搜索文档

第 1 步：检查现有配置

配置之前，请使用以下任一方法检查 AWS MCP 工具是否已可用：

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

在 Agent 的可用工具中查找以下工具名称模式：

• mcp__aws-mcp__* 或 mcp__aws__* → 已配置完整 AWS MCP 服务
• mcp__*awsdocs*__aws___* → 已配置 AWS Documentation MCP

检查方法：运行 /mcp 命令，列出所有已启用的 MCP 服务。

方法 B：检查配置文件

Agent 工具使用分层配置（优先级：本地 → 项目 → 用户 → 企业）：

范围	文件位置	用途
本地	.claude.json（位于项目中）	个人使用／实验
项目	.mcp.json（项目根目录）	团队共享
用户	~/.claude.json	跨项目个人使用
企业	系统管理的目录	组织范围

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

# Check project config
cat .mcp.json 2>/dev/null | grep -E '"(aws-mcp|aws|awsdocs)"'

# Check user config
cat ~/.claude.json 2>/dev/null | grep -E '"(aws-mcp|aws|awsdocs)"'

# Or use Claude CLI
claude mcp list

如果已配置 AWS MCP，则无需进一步设置。

第 2 步：选择配置方式

自动检测

运行以下命令，确定要使用哪种选项：

# Check for uvx (requires Python 3.10+)
which uvx || echo "uvx not available"

# Check for valid AWS credentials
aws sts get-caller-identity || echo "AWS credentials not configured"

选项 A：完整 AWS MCP 服务（推荐）

适用情况：uvx 可用，且 AWS 凭证有效

前提条件：

• Python 3.10+ 和 uv 包管理器
• 已配置 AWS 凭证（通过配置文件、环境变量或 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 配置文件（推荐用于开发）：

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

Documentation 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 未启动	更改配置后重启 Agent