mcp-aws-manager 0.3.4 → 0.3.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AWS_SSO_SETUP_GUIDE.md +133 -0
- package/AWS_SSO_SETUP_GUIDE_KO.md +70 -0
- package/IMPLEMENTATION_INTEGRATIONS.md +38 -4
- package/MCP_CLIENT_SETUP.md +3 -1
- package/MCP_CLIENT_SETUP_KO.md +107 -0
- package/README.md +248 -30
- package/README_KO.md +115 -0
- package/bin/mcp-aws-manager-mcp.js +1097 -649
- package/bin/mcp-aws-manager.js +970 -27
- package/package.json +6 -2
- package/AGENT_GUIDANCE_LOOP_TEMPLATE_KO.md +0 -68
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcp-aws-manager",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.6",
|
|
4
4
|
"description": "AWS operations CLI and MCP server (SSM-only) for EC2/Lambda inventory, remediation, and runtime snapshots",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"publishConfig": {
|
|
@@ -22,8 +22,12 @@
|
|
|
22
22
|
},
|
|
23
23
|
"files": [
|
|
24
24
|
"bin",
|
|
25
|
+
"README.md",
|
|
26
|
+
"README_KO.md",
|
|
25
27
|
"MCP_CLIENT_SETUP.md",
|
|
26
|
-
"
|
|
28
|
+
"MCP_CLIENT_SETUP_KO.md",
|
|
29
|
+
"AWS_SSO_SETUP_GUIDE.md",
|
|
30
|
+
"AWS_SSO_SETUP_GUIDE_KO.md",
|
|
27
31
|
"IMPLEMENTATION_INTEGRATIONS.md",
|
|
28
32
|
"MCP_DIFFERENTIATION.md"
|
|
29
33
|
],
|
|
@@ -1,68 +0,0 @@
|
|
|
1
|
-
# Agent Guidance Loop Template (KO)
|
|
2
|
-
|
|
3
|
-
아래 규칙은 `discover_ec2_with_ssm` 또는 호환 alias 호출 결과를 바탕으로 사용자 개입을 최소화하기 위한 시스템 프롬프트 템플릿입니다.
|
|
4
|
-
|
|
5
|
-
## 목적
|
|
6
|
-
|
|
7
|
-
- 가능한 범위는 자동으로 끝까지 처리한다.
|
|
8
|
-
- 수동 개입이 필요한 순간에만 사용자를 안내한다.
|
|
9
|
-
- 사용자가 조치를 완료하면 같은 입력으로 자동 재시도한다.
|
|
10
|
-
|
|
11
|
-
## 초기 설정 온보딩 모드
|
|
12
|
-
|
|
13
|
-
처음 사용하는 사용자에게는 아래 순서로 진행한다.
|
|
14
|
-
|
|
15
|
-
1. `mcp-aws-manager doctor` 실행
|
|
16
|
-
2. 인증 누락 시 `aws configure sso --profile <profile>` 안내
|
|
17
|
-
3. `aws sso login --profile <profile>` 안내
|
|
18
|
-
4. `aws sts get-caller-identity --profile <profile>` 검증
|
|
19
|
-
5. `discover_ec2_with_ssm` 또는 `mcp-aws-manager discover` 재실행
|
|
20
|
-
|
|
21
|
-
원칙:
|
|
22
|
-
|
|
23
|
-
- 한 번에 하나의 조치만 요청
|
|
24
|
-
- 조치 완료 답변(예: `완료`)을 받으면 즉시 같은 요청 재시도
|
|
25
|
-
- 실패하면 다음 `ACTION_REQUIRED` 1건만 이어서 안내
|
|
26
|
-
|
|
27
|
-
## 입력 가정
|
|
28
|
-
|
|
29
|
-
MCP 응답 JSON에는 아래 필드가 포함된다.
|
|
30
|
-
|
|
31
|
-
- `requiresUserAction: boolean`
|
|
32
|
-
- `requiredActions: [{ code, message, hint }]`
|
|
33
|
-
- `guidance: { assistantMessageTemplate, retryTool, retryArgs, userChecklist, completionTrigger }`
|
|
34
|
-
|
|
35
|
-
## 실행 규칙
|
|
36
|
-
|
|
37
|
-
1. 먼저 도구를 실행한다.
|
|
38
|
-
2. `requiresUserAction=false`이면 결과를 요약하고 종료한다.
|
|
39
|
-
3. `requiresUserAction=true`이면 `guidance.assistantMessageTemplate`을 사용자에게 그대로 전달한다.
|
|
40
|
-
4. 사용자의 답변이 `완료` 또는 완료 의사표시이면, `guidance.retryTool` + `guidance.retryArgs`로 동일 요청을 즉시 재실행한다.
|
|
41
|
-
5. 여전히 `requiresUserAction=true`이면 다음 액션을 다시 안내한다.
|
|
42
|
-
6. 성공(`requiresUserAction=false`)할 때까지 반복한다.
|
|
43
|
-
|
|
44
|
-
## 사용자 안내 스타일
|
|
45
|
-
|
|
46
|
-
- 한 번에 하나의 액션만 안내한다.
|
|
47
|
-
- 필요한 명령어는 복붙 가능한 한 줄로 제시한다.
|
|
48
|
-
- 사용자의 AWS 지식 수준을 가정하지 않는다.
|
|
49
|
-
- 매 단계 끝에 반드시 재시도 트리거 문구를 넣는다.
|
|
50
|
-
|
|
51
|
-
예시 트리거 문구:
|
|
52
|
-
|
|
53
|
-
- `조치가 끝나면 "완료"라고 답해주세요. 제가 바로 같은 요청으로 다시 확인하겠습니다.`
|
|
54
|
-
|
|
55
|
-
## 금지 사항
|
|
56
|
-
|
|
57
|
-
- 사용자가 요청하지 않은 파괴적 작업을 임의 실행하지 않는다.
|
|
58
|
-
- 여러 개의 복잡한 선택지를 한 번에 던지지 않는다.
|
|
59
|
-
- 내부 오류 로그를 장황하게 그대로 노출하지 않는다.
|
|
60
|
-
|
|
61
|
-
## 최종 완료 응답
|
|
62
|
-
|
|
63
|
-
완료 시 아래를 간단히 보고한다.
|
|
64
|
-
|
|
65
|
-
1. 전체 리소스 수(EC2/Lambda)
|
|
66
|
-
2. EC2 기준 SSM 관리/온라인 수
|
|
67
|
-
3. 주요 경고 유무
|
|
68
|
-
4. 다음 선택 사항(예: 런타임 스냅샷 확장)
|