mcpField
A
aws-cloud-ops

aws-cloud-ops

github.com/oimiragieo云与 DevOps4469 次安装17 周前更新
代码仓库

关于 aws-cloud-ops

aws-cloud-ops 是面向 AWS 云运维任务的 Agent 技能,调用 AWS CLI v2 管理多类 AWS 服务。它按服务类别提供渐进式工具,并将 IAM 写操作设为禁用。

主要功能

  1. 01管理 CloudWatch 日志、指标和告警
  2. 02执行 S3 对象操作
  3. 03查看及调用 Lambda 函数
  4. 04管理 EC2 实例
  5. 05只读查看 IAM 用户、角色和策略
  6. 06破坏性操作需确认

适用场景

  1. 01排查 CloudWatch 日志与指标
  2. 02同步目录或复制 S3 对象
  3. 03检查并启停 EC2 实例

MCP 相关

README 未说明 MCP 集成。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/oimiragieo/agent-studio --skill aws-cloud-ops

安装后在 Claude Code 中输入/aws-cloud-ops确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

commands/
aws-cloud-ops.md
hooks/
post-execute.cjs
pre-execute.cjs
references/
research-requirements.md
rules/
aws-cloud-ops.md
schemas/
input.schema.json
output.schema.json
scripts/
main.cjs
templates/
implementation-template.md

详细介绍

AWS Cloud Operations Skill

安装

此技能会调用 AWS CLI v2。请安装并配置:

  • Linux x86:下载 AWS CLI v2,解压,然后运行 sudo ./aws/install
  • macOS:运行 curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg",然后运行安装程序
  • Windows:从 AWS CLI v2 下载 MSI,或使用 msiexec;也可以通过包管理器安装

配置:aws configure(访问密钥、私有密钥、区域)。验证:aws --version

速查表与最佳实践

身份与配置: aws sts get-caller-identity — 查看当前身份;aws configure list-profiles — 列出配置文件。

S3: aws s3 ls;aws s3 cp <local> s3://bucket/;aws s3 sync ./dir s3://bucket/;aws s3 rm s3://bucket/key。

Lambda: aws lambda list-functions;aws lambda invoke --function-name X output.json;aws lambda get-function --function-name X。

CloudWatch: aws cloudwatch list-metrics;aws cloudwatch get-metric-statistics;aws cloudwatch describe-alarms;使用 put-metric-alarm 设置警报。

EC2: aws ec2 describe-instances;搭配 --instance-ids 使用 start-instances/stop-instances/terminate-instances。

最佳实践: 优先使用 IAM 角色,而非长期密钥;设置 AWS_REGION/AWS_PROFILE;使用 --output json 和 --query 限制响应大小;执行破坏性操作前,先运行 describe 确认资源。

认证与培训

免费: AWS Skill Builder — 考试准备、Cloud Quest、Cloud Essentials。Cloud Practitioner (CLF-C02): 云概念、安全与合规、技术与服务、计费(约 6 个月的相关经验)。Solutions Architect Associate: 下一步;可通过 Skill Builder 备考。

技能数据: 涵盖 S3、Lambda、CloudWatch、EC2、IAM;遵循安全最佳实践;不硬编码凭证。

钩子与工作流

建议的钩子: 部署前:验证凭证(aws sts get-caller-identity)。成本跟踪钩子:可选的 CloudWatch/计费检查。没有强制钩子;为 AWS 任务路由 devops 时使用。

工作流: 与 devops 配合使用(上下文:aws_project)。流程:检测 AWS 项目 → 加载 aws-cloud-ops → 通过技能脚本运行 CLI。调试 AWS 资源时,请参阅 operations/incident-response。

概述

与原始 AWS MCP 服务相比,可节省 90% 以上的上下文。支持多项服务,并按服务类别渐进式披露。

要求

  • AWS CLI v2
  • 已配置凭证(AWS_PROFILE 或 ~/.aws/credentials)
  • AWS_REGION 环境变量

工具(渐进式披露)

CloudWatch 操作
工具描述是否需要确认
logs-groups列出日志组否
logs-tail查看日志流末尾否
logs-filter筛选日志事件否
metrics-list列出指标否
metrics-get获取指标数据否
alarm-list列出警报否
alarm-create创建警报是
S3 操作
工具描述是否需要确认
s3-ls列出存储桶/对象否
s3-cp复制对象是
s3-sync同步目录是
s3-rm删除对象是
Lambda 操作
工具描述是否需要确认
lambda-list列出函数否
lambda-get获取函数详情否
lambda-invoke调用函数是
lambda-logs获取函数日志否
EC2 Operations
工具描述确认
ec2-list列出实例否
ec2-describe描述实例否
ec2-start启动实例是
ec2-stop停止实例是
sg-list列出安全组否
IAM Operations(只读)
工具描述确认
iam-users列出用户否
iam-roles列出角色否
iam-policies列出策略否

快速参考

# List EC2 instances
aws ec2 describe-instances --output table

# Tail CloudWatch logs
aws logs tail /aws/lambda/my-function --follow

# List S3 buckets
aws s3 ls

# Invoke Lambda
aws lambda invoke --function-name my-func output.json

配置

  • AWS_PROFILE:要使用的命名配置文件
  • AWS_REGION:目标区域(例如,us-east-1)
  • AWS_DEFAULT_OUTPUT:输出格式(json/table/text)

安全

⚠️ 切勿将凭据硬编码 ⚠️ 尽可能使用 IAM 角色 ⚠️ IAM 写入操作已禁止

Agent 集成

  • devops(主要):云操作
  • cloud-integrator(主要):多云
  • incident-responder(次要):故障排查

故障排查

问题解决方案
拒绝访问检查 IAM 权限
区域错误设置 AWS_REGION
凭据运行 aws configure

Memory Protocol(强制)

开始前: 阅读 .claude/context/memory/learnings.md

完成后:

  • 新模式 -> .claude/context/memory/learnings.md
  • 发现问题 -> .claude/context/memory/issues.md
  • 做出决策 -> .claude/context/memory/decisions.md

假设任务会中断:如果没有记录在记忆中,就代表它没有发生。

评论

支持 Markdown