教程2026-10-26 · 智涌AI

AWS Agent Toolkit MCP 上手：本机装 Skills 并握手

MCPSkillAgent编程工具
AWS Agent Toolkit MCP 上手：本机安装 Skills 并用 mcp-proxy 无凭证握手列出工具

AWS 把面向编程 Agent 的官方能力收成 Agent Toolkit for AWS：托管的 AWS MCP Server、经过评估的 Skills，以及给 Claude Code / Codex / Cursor / Devin / Kiro 用的插件。站内快讯《AWS Agent Toolkit：官方 MCP+Skills》说过它是什么；这篇在本机把仓库拆开、装两条 Skill，并用 mcp-proxy-for-aws-cli 对官方端点做了一次 --skip-auth 握手，确认文档检索和 Region 列表在无凭证时也能跑通。

站内已有 MCP 入门、Skill 和 MCP 怎么分工、Claude Code MCP Tasks、Infinity 运行时。这篇只盯「官方 AWS 层怎么接到你现有的编程 Agent」。

前置条件

先分清：Toolkit 不是又一个聊天 Agent

官方用户指南写明：Agent Toolkit for AWS 自己没有聊天界面、也没有模型。你继续用 Claude Code / Codex / Cursor 等；Toolkit 只提供连 AWS 的那一层——工具调用、当前文档、以及走 IAM 的路径。

组件干什么本机怎么摸到
AWS MCP Server托管远程 MCP：搜文档、查 Region、沙箱跑 Python、调 APIuvx mcp-proxy-for-aws-cli==1.7.0 代理到 https://aws-mcp.us-east-1.api.aws/mcp
Agent Skills按任务加载的步骤/决策/踩坑材料仓库 skills/；或 npx skills add aws/agent-toolkit-for-aws/skills
Plugins一键捆绑 MCP 配置 + 精选 Skills（如 aws-core 1.2.0）Claude Code /plugin install aws-core@claude-plugins-official（本机未装插件）
Rules项目级持久指令：优先 MCP、先找 Skill、偏 IaC仓库 rules/aws-agent-rules.md，拷进 CLAUDE.md / AGENTS.md

产品页写明 Toolkit 额外不收费；你只付 Agent 实际创建或调用的 AWS 资源。搜文档、发现 Skill 可以不登录。

第 1 步：克隆仓库，看清 Skills 盘子

git clone --depth 1 https://github.com/aws/agent-toolkit-for-aws.git
cd agent-toolkit-for-aws
find skills -name SKILL.md | wc -l   # 本文：118
ls plugins/   # aws-core / aws-agents / aws-data-analytics / aws-agents-for-devsecops / aws-startup-advisor

aws-core 的 plugin.json 版本是 1.2.0，自带的 MCP 片段会拉 mcp-proxy-for-aws-cli==1.7.0，并带 --skip-auth（方便先看工具列表；真要调 API 还得换成凭证或 OAuth）。Rules 文件会要求：能走 MCP 就别瞎 Bash 调 CLI；动 Secrets Manager 必须先加载对应 Skill，禁止把密钥明文读进上下文。

第 2 步：用 npx skills 装两条到本地

mkdir demo && cd demo
npx skills add aws/agent-toolkit-for-aws/skills -l          # 列出 118 条
npx skills add aws/agent-toolkit-for-aws/skills \
  --skill aws-iam --skill securing-s3-buckets -y
npx skills list
终端：npx skills 发现 118 条 Skill，并成功安装 aws-iam 与 securing-s3-buckets
2026-10-26 本机：发现 118 条 Skill；安装 aws-iam、securing-s3-buckets 到 ./.agents/skills/。

安装完成后会有 skills-lock.json（记下 source 与 content hash）。Skill 会复制到 Cursor / Codex / OpenCode 等 Agent 目录——装上前先打开 SKILL.md，确认它会不会动到生产资源。

第 3 步：MCP 代理握手（--skip-auth）

uvx mcp-proxy-for-aws-cli==1.7.0 \
  https://aws-mcp.us-east-1.api.aws/mcp \
  --skip-auth \
  --metadata INSTALL_SOURCE=local-test

对这个 stdio 进程发 JSON-RPC initialize（协议 2025-11-25）后，返回的 serverInfo 是 MCP Proxy for AWS / 1.7.0。tools/list 给出 8 个工具：

终端摘要：MCP 代理 1.7.0 握手成功，列出 8 个工具；list_regions 返回 37 个区域；retrieve_skill 拉回 aws-iam
无 AWS 凭证：list_regions 返回 37 个区域；retrieve_skill(aws-iam) 拉回约 6.4KB 的 SKILL 正文。

实测调用：

未实测（写明原因）：

第 4 步：接进你的 Agent（按官方路径抄）

选一条和你编辑器匹配的安装方式（命令以官方 Getting started 为准）：

建议立刻把仓库里的 rules/aws-agent-rules.md 拷进项目规则文件，并自己加：默认 Region、命名规范、生产账号只读。验证连接时，官方建议新开对话问一句「What AWS Regions are available?」——对应我们本机用 list_regions 跑通的那条路径。

生产前：条件键怎么用（概念核对）

用户指南写明：经 AWS MCP Server 出去的请求会自动带上全局条件键 aws:ViaAWSMCPService 与 aws:CalledViaAWSMCP。这样你可以在同一套 IAM 身份上写「人手可以发布，Agent 只能只读」——关键是把来路拆开，而不是再发一把万能钥匙。CloudWatch 看工具调用量，CloudTrail 留 API 审计。具体策略例句以「Identity-based policy examples for AWS MCP Server」文档页为准；本文没有在真实账号里 Apply 策略。

鉴权有两条官方路径：本地 mcp-proxy-for-aws 走 SigV4（可多 profile），或 OAuth 2.1 直连、少装一层代理。多账号对比配置时，文档提醒 OAuth 会话绑死单一角色，不能中途换 profile。

和 Infinity、Labs 旧件怎么摆

Infinity 解决的是「很多 Agent 进程怎么挂起、省内存」；Toolkit 解决的是「Agent 怎么安全、带着当前文档去动云资源」。两者叠得上，但不是互相替代。AWS Labs 上的旧 MCP/Skills 官方说会继续可用、继续收贡献，长期会把好的能力迁进 Toolkit——新项目直接用 Toolkit 即可，旧流水线不必半夜强迁。

常见坑

本机验证顺序可以记成三步：先 skills -l 确认盘子，再 --skip-auth 握手看 8 个工具名，最后（有账号时）用最小权限角色问一句 Region 列表。三步都过，再让 Agent 碰 CloudFormation 或 IAM。

完成标准

最后

已经在用编程 Agent 管 AWS 的人：先装 aws-core（或等价 MCP 配置）+ 规则文件，把生产写权限用条件键收紧，再让 Agent 碰基础设施。下一步可以直接打开站内快讯原文对照产品能力，或去仓库 Issues/Docs 跟插件更新。

信息来源

相关教程

延伸阅读

更多实用教程 →

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测，也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注；不用微信的话，可以用 RSS 订阅本站。