mcp-aws-manager 0.4.1 → 0.4.2

package/README.md

@@ -8,6 +8,7 @@ This package orchestrates AWS operations (inventory/runtime/remediation) with a
 
 ```bash
 npm install -g mcp-aws-manager
+mcp-aws-manager --version
 mcp-aws-manager
 mcp-aws-manager doctor
 mcp-aws-manager discover --profiles default --no-progress
@@ -152,16 +153,33 @@ Optional explicit registration:
 
 ```bash
 mcp-aws-manager setup
-mcp-aws-manager setup --clients codex,claude
-mcp-aws-manager setup --clients cursor,windsurf,antigravity
+mcp-aws-manager setup --clients cursor
+mcp-aws-manager setup --clients codex
+mcp-aws-manager setup --clients claude
 ```
 
+Default behavior (`setup`/`bootstrap` without `--clients`) auto-detects installed clients and registers only detected CLIs.
+
 2. Health check:
 
 ```bash
 mcp-aws-manager doctor
 ```
 
+Default behavior (`doctor` without `--clients`) auto-detects installed clients and skips non-installed CLIs.
+
+### Agent Instruction Snippet (Any Client)
+
+When asking an agent to check AWS status, use this exact sequence first:
+
+```bash
+mcp-aws-manager setup --force
+mcp-aws-manager doctor
+mcp-aws-manager discover --profiles default --no-progress
+```
+
+Require the agent to include `runId`/`started_at` (live run evidence) in the response. If missing, treat it as file-only/cached summary.
+
 3. Configure AWS auth (SSO recommended):
 
 ```bash

package/README_KO.md

@@ -8,6 +8,7 @@ SSM 우선(SSM-first) 방식의 AWS 운영 CLI + MCP stdio 서버입니다.
 
 ```bash
 npm install -g mcp-aws-manager
+mcp-aws-manager --version
 mcp-aws-manager
 mcp-aws-manager doctor
 mcp-aws-manager discover --profiles default --no-progress
@@ -152,16 +153,33 @@ bootstrap/setup 기본 동작은 단일 서버 1개를 등록합니다.
 
 ```bash
 mcp-aws-manager setup
-mcp-aws-manager setup --clients codex,claude
-mcp-aws-manager setup --clients cursor,windsurf,antigravity
+mcp-aws-manager setup --clients cursor
+mcp-aws-manager setup --clients codex
+mcp-aws-manager setup --clients claude
 ```
 
+기본 동작(`--clients` 없이 `setup`/`bootstrap`)은 설치된 클라이언트를 자동 감지해, 감지된 CLI만 등록합니다.
+
 2. 상태 점검:
 
 ```bash
 mcp-aws-manager doctor
 ```
 
+기본 동작(`--clients` 없이 `doctor`)은 설치된 클라이언트를 자동 감지하고, 미설치 CLI는 skip 처리합니다.
+
+### 에이전트 지시용 공통 스니펫
+
+에이전트에게 AWS 상태 점검을 지시할 때는 먼저 아래 순서를 그대로 실행하도록 요청하세요.
+
+```bash
+mcp-aws-manager setup --force
+mcp-aws-manager doctor
+mcp-aws-manager discover --profiles default --no-progress
+```
+
+응답에는 반드시 `runId`/`started_at`(라이브 실행 증거)를 포함하도록 요구하세요. 없으면 파일 기반/캐시 요약으로 간주하세요.
+
 3. AWS 인증 설정(권장: SSO):
 
 ```bash

package/bin/mcp-aws-manager.js

@@ -723,6 +723,8 @@ function usageText() {
   return [
     "Usage:",
     "  mcp-aws-manager",
+    "  mcp-aws-manager version",
+    "  mcp-aws-manager --version",
     "  mcp-aws-manager bootstrap [options]",
     "  mcp-aws-manager setup [options]",
     "  mcp-aws-manager doctor [options]",
@@ -734,6 +736,7 @@ function usageText() {
     "SSM-first AWS inventory/runtime collector (EC2/Lambda/ALB/ASG/RDS/ElastiCache/Route53 + VPC/ECS/S3/IAM/KMS/CloudWatch/CloudTrail/Config/ECR/DynamoDB/SNS/SQS/Budgets/CostAnomaly + EBS/EFS/EKS/APIGateway/CloudFront/WAF/Shield/StepFunctions/CloudWatchLogs/X-Ray/Inspector2/Redshift/OpenSearch/Organizations/ControlTower + ACM/Kinesis/MSK) plus MCP client setup helper.",
     "",
     "Commands:",
+    "  version                 Print CLI package version",
     "  bootstrap               Ensure mcp-aws-manager MCP server is registered (default command)",
     "  setup                   Register/re-register MCP server for supported clients",
     "  doctor                  Check install and registration health",
@@ -743,7 +746,7 @@ function usageText() {
     "",
     "Setup/Bootstrap/Doctor options:",
     "  (target: mcp-aws-manager => auto-resolved runtime command for mcp-aws-manager-mcp)",
-    `  --clients <${clientList}>        (default: codex,claude)`,
+    `  --clients <${clientList}>        (default: auto-detect installed clients)`,
     "  --force                         (setup/bootstrap only; always remove then add)",
     "  -h, --help",
     "",
@@ -995,6 +998,9 @@ function parseCommand(argv) {
   }
 
   const first = String(args[0] || "");
+  if (first === "-v" || first === "--version" || first === "version") {
+    return { command: "version", args: [] };
+  }
   if (first === "-h" || first === "--help") {
     return { command: "help", args: [] };
   }
@@ -1071,10 +1077,12 @@ function parseRegistrationArgs(argv, opts = {}) {
   }
 
   const defaultTarget = resolveDefaultRegistrationTarget();
+  const clientsExplicit = Boolean(options.clients && String(options.clients).trim());
   return {
     help: false,
     targets: [defaultTarget],
-    clients: options.clients ? parseClients(options.clients) : ["codex", "claude"],
+    clients: options.clients ? parseClients(options.clients) : Array.from(SUPPORTED_CLIENTS),
+    clientsExplicit,
     force: options.force
   };
 }
@@ -2460,15 +2468,26 @@ function targetCommandLabel(target) {
   return [command, ...args].join(" ");
 }
 
+function detectClientAvailability(clients) {
+  const candidateClients = Array.isArray(clients) && clients.length
+    ? clients
+    : Array.from(SUPPORTED_CLIENTS);
+  return candidateClients.map((cliBin) => {
+    const exists = clientHelpAttempts(cliBin).some((args) => commandExists(cliBin, args));
+    return { cliBin, exists };
+  });
+}
+
 function runSetupInternal(config, options = {}) {
   const ensureOnly = options.ensureOnly === true;
   const defaultTarget = resolveDefaultRegistrationTarget();
   const targets = Array.isArray(config.targets) && config.targets.length
     ? config.targets
     : [defaultTarget];
-  const clients = config.clients.filter((cli) =>
-    clientHelpAttempts(cli).some((args) => commandExists(cli, args))
-  );
+  const clientsExplicit = config && config.clientsExplicit === true;
+  const availability = detectClientAvailability(config.clients);
+  const clients = availability.filter((row) => row.exists).map((row) => row.cliBin);
+  const missingClients = availability.filter((row) => !row.exists).map((row) => row.cliBin);
   const results = [];
   const commandChecks = targets.map((target) => ({
     ...target,
@@ -2477,7 +2496,11 @@ function runSetupInternal(config, options = {}) {
 
   process.stdout.write(ensureOnly ? "Bootstrap start.\n" : "Setup start.\n");
   process.stdout.write(`Targets: ${targets.map((t) => `${t.serverName}=>${targetCommandLabel(t)}`).join(", ")}\n`);
-  process.stdout.write(`Clients: ${config.clients.join(",")}\n`);
+  process.stdout.write(`Clients(requested): ${availability.map((row) => row.cliBin).join(",")}\n`);
+  process.stdout.write(`Clients(detected): ${clients.length ? clients.join(",") : "none"}\n`);
+  if (!clientsExplicit && missingClients.length) {
+    process.stdout.write(`Clients(skipped): ${missingClients.join(",")} (not installed or not available in PATH)\n`);
+  }
 
   if (!clients.length) {
     process.stdout.write(`No supported client CLI found. Supported: ${Array.from(SUPPORTED_CLIENTS).join(", ")}\n`);
@@ -2546,8 +2569,11 @@ function runDoctor(config) {
   const targets = Array.isArray(config.targets) && config.targets.length
     ? config.targets
     : [defaultTarget];
+  const clientsExplicit = config && config.clientsExplicit === true;
+  const availability = detectClientAvailability(config.clients);
   process.stdout.write("Doctor start.\n");
   process.stdout.write(`Targets: ${targets.map((t) => `${t.serverName}=>${targetCommandLabel(t)}`).join(", ")}\n`);
+  process.stdout.write(`Clients(requested): ${availability.map((row) => row.cliBin).join(",")}\n`);
   let hasIssue = false;
   let foundClient = false;
 
@@ -2563,11 +2589,15 @@ function runDoctor(config) {
     }
   }
 
-  for (const cliBin of config.clients) {
-    const exists = clientHelpAttempts(cliBin).some((args) => commandExists(cliBin, args));
-    if (!exists) {
-      hasIssue = true;
-      process.stdout.write(`${cliBin}: not installed or not available in PATH\n`);
+  for (const row of availability) {
+    const cliBin = row.cliBin;
+    if (!row.exists) {
+      if (clientsExplicit) {
+        hasIssue = true;
+        process.stdout.write(`${cliBin}: not installed or not available in PATH\n`);
+      } else {
+        process.stdout.write(`${cliBin}: skipped (not installed or not available in PATH)\n`);
+      }
       continue;
     }
 
@@ -2586,6 +2616,7 @@ function runDoctor(config) {
   }
 
   if (!foundClient) {
+    hasIssue = true;
     process.stdout.write("No requested clients detected. Install at least one supported client first.\n");
   }
 
@@ -12065,6 +12096,11 @@ async function runWorkflow(config) {
 async function main() {
   try {
     const parsed = parseCommand(process.argv.slice(2));
+    if (parsed.command === "version") {
+      process.stdout.write(`${readCurrentPackageVersion()}\n`);
+      process.exitCode = 0;
+      return;
+    }
     if (parsed.command === "help") {
       process.stdout.write(usageText());
       process.exitCode = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-aws-manager",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "AWS operations CLI and MCP server (SSM-only) for EC2/Lambda inventory, remediation, and runtime snapshots",
   "license": "MIT",
   "publishConfig": {