用途:为 AI 代理配置 AWS MCP 服务器,实现 AWS 文档搜索与 API 调用。适用场景包括搭建 AWS MCP、配置 AWS 文档工具、排查 MCP 连接问题,以及用户提到 aws-mcp、awsdocs、uvx setup 或 MCP 服务器配置时。
主要能力与两种方案:
- 完整 AWS MCP 服务器:要求 Python 3.10+、uvx、AWS 凭证;可执行 AWS API 调用并搜索文档。
- AWS Documentation MCP:无前置要求,仅文档搜索。
使用方式: 先检查是否已配置:运行 /mcp 查看已激活的 MCP 服务器,或查找工具名模式 mcp__aws-mcp__、mcp__aws__(完整版)与 mcp__awsdocsaws_*(文档版)。也可检查分层配置文件(本地 .claude.json、项目 .mcp.json、用户 ~/.claude.json、企业托管目录)中的 mcpServers,或执行 claude mcp list。 自动检测命令:which uvx;aws sts get-caller-identity。 当 uvx 可用且 AWS 凭证有效时用完整版。所需 IAM 权限包含 aws-mcp:InvokeMCP、aws-mcp:CallReadOnlyTool、aws-mcp:CallReadWriteTool。配置示例:命令 uvx,参数 mcp-proxy-for-aws@latest、https://aws-mcp.us-east-1.api.aws/mcp、--metadata AWS_REGION=us-west-2。凭证支持 AWS Profile(--profile)、环境变量或 IAM 角色;附加选项有 --region、--read-only、--log-level。 无 Python/uvx 或凭证、仅需文档搜索时用文档版:type 为 http,url 为 https://knowledge-mcp.global.api.aws。
验证:完整版查看 mcp__aws-mcp__aws___search_documentation、mcp__aws-mcp__aws___call_aws;文档版查看 mcp__awsdocs__aws___search_documentation、mcp__awsdocs__aws___read_documentation。
限制与排错:uvx 未安装可 pip install uv 或改用方案 B;AccessDenied 需补充 IAM 权限;InvalidSignatureException 检查凭证;工具未出现需重启代理。仅在上游来源与本地项目上下文明确匹配时使用;应用变更前应验证命令、生成代码、依赖、凭证与外部服务行为,示例不能替代环境特定测试、安全审查或对破坏性/高成本操作的用户批准。