在 agentic-awesome-skills 中配置 AWS MCP 服务器文档搜索与 API 访问的完整实战指南【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/GitHub_Trending/an/agentic-awesome-skills本篇技术指南以仓库内aws-mcp-setup技能文档SKILL.md为核心系统讲解如何为 AI Agent 配置 AWS MCP 工具。读完本文你将掌握完整 AWS MCP Server 与 AWS Documentation MCP 两种方案的选型标准、配置方法、凭据接入方式、验证步骤与常见故障排查手段并了解该技能在 agentic-awesome-skills 仓库中的定位与配套生态。一、何时使用本指南当出现以下场景时应使用aws-mcp-setup技能的配置方法需要为 Agent 配置 AWS MCP 服务器以进行文档搜索与 API 访问需要配置 AWS 文档工具AWS documentation tools排查 MCP 连接类问题用户提到aws-mcp、awsdocs、uvx setup或 MCP 服务器配置等关键词。该技能在仓库目录中登记为独立条目见 data/catalog.json其risk声明为critical说明这是一类直接影响凭据与云端资源访问的高风险配置操作配置完成后务必按本文「验证」章节逐步核对。二、方案概览两种配置选项对比AWS MCP 工具面向 AI Agent 提供两种可选接入方案方案前置条件能力范围完整 AWS MCP ServerFull AWS MCP ServerPython 3.10、uvx、AWS 凭据可执行 AWS API 调用 文档搜索AWS 文档 MCPAWS Documentation MCP无仅文档搜索核心区别在于完整方案通过mcp-proxy-for-aws代理访问 AWS 托管 MCP 端点既支持文档检索也支持真实 API 调用受 IAM 权限约束文档方案则是零鉴权的只读搜索服务适合无凭据、仅需查阅文档的场景。三、第一步检查现有配置在动手配置前先确认 Agent 环境中是否已存在可用的 AWS MCP 工具两种检查方式任选其一。方法 A检查可用工具推荐在 Agent 的可用工具列表中查找以下命名模式mcp__aws-mcp__*或mcp__aws__*→ 已配置完整 AWS MCP Servermcp__*awsdocs*__aws___*→ 已配置 AWS Documentation MCP。如何检查在 Agent 中运行/mcp命令即可列出所有已激活的 MCP 服务器。方法 B检查配置文件Agent 工具的 MCP 配置遵循层级优先级本地local→ 项目project→ 用户user→ 企业enterprise作用域越小优先级越高作用域配置文件位置适用场景Local项目内的.claude.json个人/实验性配置Project项目根目录的.mcp.json团队共享配置User~/.claude.json跨项目的个人配置Enterprise系统托管目录组织级统一配置检查这些文件中是否存在包含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 配置则无需重复设置直接跳过后续步骤。四、第二步选择配置方法自动检测环境运行以下命令判断本机应使用哪种方案# 检查 uvx 是否可用要求 Python 3.10 which uvx || echo uvx not available # 检查 AWS 凭据是否有效 aws sts get-caller-identity || echo AWS credentials not configured判定逻辑uvx可用且AWS 凭据有效 → 选择方案 A两者任一不满足且仅需文档查询 → 选择方案 B。方案 A完整 AWS MCP Server推荐适用条件uvx 可用且 AWS 凭据有效。前置条件Python 3.10并安装uv包管理器提供uvx命令AWS 凭据已配置可通过 profile、环境变量或 IAM 角色任一方式。所需 IAM 权限执行 API 调用前需要为调用方身份授予如下权限策略其中三个动作分别对应 MCP 调用入口、只读工具与读写工具{ 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-awslatest, https://aws-mcp.us-east-1.api.aws/mcp, --metadata, AWS_REGIONus-west-2 ] } } }配置要点command使用uvx直接运行mcp-proxy-for-awslatest第二个参数为 AWS 托管 MCP 端点地址--metadata用于向代理传递AWS_REGION元数据此处示例默认覆盖为us-west-2。凭据接入的三种方式AWS Profile推荐用于开发环境——在args中追加--profile参数args: [ mcp-proxy-for-awslatest, https://aws-mcp.us-east-1.api.aws/mcp, --profile, my-profile, --metadata, AWS_REGIONus-west-2 ]环境变量——通过env字段注入凭据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。注意mcp-proxy-for-aws为上游开源代理项目本文不展开其内部实现生产使用前请结合其官方文档确认与当前 AWS 托管端点的兼容版本。方案 BAWS Documentation MCP Server免鉴权适用条件无 Python/uvx 环境无 AWS 凭据仅需文档搜索无需执行 API 调用。配置{ mcpServers: { awsdocs: { type: http, url: https://knowledge-mcp.global.api.aws } } }该方案通过标准 HTTP MCP 端点接入 AWS 知识库服务搜索能力由服务端托管本地零依赖、零鉴权是轻量接入的首选。五、第三步验证配置生效配置修改完成后回到 Agent 的工具列表核对期望的工具是否出现完整 AWS MCP 方案应能看到mcp__aws-mcp__aws___search_documentation文档搜索mcp__aws-mcp__aws___call_awsAWS API 调用文档 MCP 方案应能看到mcp__awsdocs__aws___search_documentationmcp__awsdocs__aws___read_documentation若工具未出现通常是 MCP 服务器未随 Agent 重启而加载先重启 Agent 再核对。六、故障排查速查表问题现象可能原因解决方案uvx: command not found未安装 uv执行pip install uv或改用方案 BAccessDenied错误缺少 IAM 权限在 IAM 策略中补充aws-mcp:*权限InvalidSignatureException凭据问题运行aws sts get-caller-identity检查凭据有效性工具不出现MCP 未启动修改配置后重启 Agent七、在 agentic-awesome-skills 仓库中的定位与配套阅读aws-mcp-setup是仓库收录的 2400 项 Agentic Skills 之一登记在目录数据 data/catalog.json 中其source指向社区上游zxkane/aws-skillssource_type为community采用 MIT 许可。在 plugins 目录中它同时存在于 agentic-awesome-skills 与 agentic-awesome-skills-claude 两套插件树中可随插件安装直接交付。仓库本身还提供了一套与 MCP 生态深度相关的控制平面——AAS Core见 docs/users/aas-core.md它通过只读本地 MCP 服务器暴露search_skills、get_skill、compose_stack等工具让 Agent 检索完整目录并精确选择技能 ID再以aas stack validate/aas stack plan完成校验与不可变计划预览。你可以将其理解为两条并行的 MCP 配置线技能接入层本文主题aws-mcp-setup负责让 Agent 获得 AWS 的文档搜索与 API 执行能力属于工具供给侧配置技能选择层AAS Core本地 MCP 负责让 Agent 在可信目录中检索并固化所选技能清单属于技能治理侧配置。两者配置入口不同前者在 Agent 的mcpServers中新增aws-mcp/awsdocs条目后者通过aas mcp configure --host codex|claude管理受控 MCP 配置段但都遵循同一原则MCP 端点只负责能力暴露是否调用、如何调用由 Agent 判断且配置后都需重启宿主使配置生效。若你的 Agent 栈同时使用 AAS Core 与 AWS MCP建议先按 docs/users/aas-core.md 完成本地目录 MCP 的配置与审批流再叠加本文的 AWS 方案避免两个配置段相互覆盖。八、限制与安全注意事项仅当任务与上游源及本地项目上下文明确匹配时才应使用本技能应用任何更改前务必验证命令、生成的代码、依赖、凭据及外部服务行为不得将示例直接当作生产环境的替代验证环境特定测试、安全评审以及针对破坏性或高成本操作的明确授权仍然必不可少完整方案涉及真实 AWS 调用凭据应遵循最小权限原则仅授予所需 IAM 动作并在共享或实验环境中优先使用--read-only修改任何 MCP 配置后需重启 Agent 进程否则新工具不会出现在可用工具列表中。【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/GitHub_Trending/an/agentic-awesome-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考