@ampless/mcp-server 1.0.0-alpha.14 → 1.0.0-alpha.16

package/README.ja.md

@@ -130,9 +130,14 @@ AI に投稿本文を生成させる場合は、markdown を指定するのが
 ampless-mcp [options]
 
   --outputs <path>        amplify_outputs.json へのパス（AMPLESS_MCP_OUTPUTS でも指定可）
+  --site-name <name>      コンテキスト用のサイト表示名（AMPLESS_MCP_SITE_NAME でも指定可、例: "mysite.net"）
+  --site-url <url>        ツール結果に含めるサイト URL（AMPLESS_MCP_SITE_URL でも指定可、省略可）
+  --environment <env>     デプロイ環境: prod | stg | dev（AMPLESS_MCP_ENVIRONMENT でも指定可、デフォルト "dev"）
   --site-id <id>          クエリのデフォルト siteId（AMPLESS_MCP_SITE_ID でも指定可、デフォルト "default"）
 ```
 
+`--site-name` を設定すると、MCP クライアントに表示されるサーバー名にサイトと環境が含まれ（例: `@ampless/mcp-server [mysite.net/prod]`）、ツールの description に `[mysite.net / prod]` が前置され、結果が `{ site, result }` でラップされます。`--environment prod` 設定時、破壊的ツール（`delete_post`、`delete_static_file`、`upload_static_bundle`）の呼び出しにはサイト名と一致する `confirmSite` 引数が必要です。
+
 必須の環境変数：
 
 ```

package/README.md

@@ -130,9 +130,14 @@ If you're letting the AI generate post bodies, asking for markdown is usually ea
 ampless-mcp [options]
 
   --outputs <path>        Path to amplify_outputs.json (also AMPLESS_MCP_OUTPUTS)
+  --site-name <name>      Site display name for context (also AMPLESS_MCP_SITE_NAME; e.g. "mysite.net")
+  --site-url <url>        Site URL included in tool results (also AMPLESS_MCP_SITE_URL; optional)
+  --environment <env>     Deployment environment: prod | stg | dev (also AMPLESS_MCP_ENVIRONMENT; default "dev")
   --site-id <id>          Default siteId for queries (also AMPLESS_MCP_SITE_ID; default "default")
 ```
 
+When `--site-name` is set, the server name shown in MCP clients includes the site and environment (e.g. `@ampless/mcp-server [mysite.net/prod]`), tool descriptions are prefixed with `[mysite.net / prod]`, and results are wrapped in `{ site, result }`. Destructive tools (`delete_post`, `delete_static_file`, `upload_static_bundle`) require a `confirmSite` argument equal to the site name when `--environment prod` is set.
+
 Required env:
 
 ```

package/dist/{chunk-K4GTND6P.js → chunk-HVSLKTKC.js}

@@ -894,7 +894,8 @@ var tools = [
     name: "delete_post",
     description: "Delete a post by postId. Also drops associated PostTag index entries.",
     inputSchema: deletePostSchema,
-    handler: (args, ctx) => deletePost(ctx.graphql, args)
+    handler: (args, ctx) => deletePost(ctx.graphql, args),
+    destructive: true
   },
   {
     name: "upload_media",
@@ -916,7 +917,8 @@ var tools = [
       ctx.graphql,
       ctx.storage(),
       args
-    )
+    ),
+    destructive: true
   },
   {
     name: "upload_static_file",
@@ -934,7 +936,8 @@ var tools = [
     handler: (args, ctx) => deleteStaticFile(
       ctx.storage(),
       args
-    )
+    ),
+    destructive: true
   },
   {
     name: "commit_static_post",

package/dist/index.js

@@ -24,7 +24,7 @@ import {
 } from "./chunk-USNYVOYF.js";
 import {
   tools
-} from "./chunk-K4GTND6P.js";
+} from "./chunk-HVSLKTKC.js";
 import {
   eventStreamSerdeProvider2 as eventStreamSerdeProvider,
   resolveEventStreamSerdeConfig
@@ -10898,6 +10898,22 @@ function parseArgs(argv) {
       out.outputs = argv[++i2];
     } else if (arg.startsWith("--outputs=")) {
       out.outputs = arg.slice("--outputs=".length);
+    } else if (arg === "--site-name") {
+      out.siteName = argv[++i2];
+    } else if (arg.startsWith("--site-name=")) {
+      out.siteName = arg.slice("--site-name=".length);
+    } else if (arg === "--site-url") {
+      out.siteUrl = argv[++i2];
+    } else if (arg.startsWith("--site-url=")) {
+      out.siteUrl = arg.slice("--site-url=".length);
+    } else if (arg === "--environment") {
+      out.environment = argv[++i2];
+    } else if (arg.startsWith("--environment=")) {
+      out.environment = arg.slice("--environment=".length);
+    } else if (arg === "--site-id") {
+      out.siteId = argv[++i2];
+    } else if (arg.startsWith("--site-id=")) {
+      out.siteId = arg.slice("--site-id=".length);
     }
   }
   return out;
@@ -10934,10 +10950,27 @@ async function loadConfig2(argv = process.argv.slice(2)) {
   if (!outputs.data?.url) {
     throw new Error("mcp-server: outputs.data.url missing");
   }
+  const siteName = args.siteName ?? process.env.AMPLESS_MCP_SITE_NAME;
+  let site;
+  if (siteName) {
+    const rawEnv = args.environment ?? process.env.AMPLESS_MCP_ENVIRONMENT ?? "dev";
+    if (rawEnv !== "prod" && rawEnv !== "stg" && rawEnv !== "dev") {
+      throw new Error(
+        `mcp-server: --environment must be one of prod, stg, dev (got "${rawEnv}")`
+      );
+    }
+    site = {
+      name: siteName,
+      url: args.siteUrl ?? process.env.AMPLESS_MCP_SITE_URL,
+      environment: rawEnv,
+      siteId: args.siteId ?? process.env.AMPLESS_MCP_SITE_ID ?? "default"
+    };
+  }
   return {
     outputs,
     email: requireEnv("AMPLESS_MCP_EMAIL"),
-    password: requireEnv("AMPLESS_MCP_PASSWORD")
+    password: requireEnv("AMPLESS_MCP_PASSWORD"),
+    site
   };
 }
 
@@ -32167,6 +32200,60 @@ var StorageClient = class {
   }
 };
 
+// src/site.ts
+function buildServerName(site) {
+  if (!site) return "@ampless/mcp-server";
+  return `@ampless/mcp-server [${site.name}/${site.environment}]`;
+}
+function decorateToolListing(tools2, site) {
+  if (!site) {
+    return tools2.map((t8) => ({
+      name: t8.name,
+      description: t8.description,
+      inputSchema: t8.inputSchema
+    }));
+  }
+  return tools2.map((t8) => {
+    const isProdDestructive = t8.destructive === true && site.environment === "prod";
+    const envLabel = site.environment === "prod" ? "PROD" : site.environment;
+    let description;
+    if (isProdDestructive) {
+      description = `[${site.name} / ${envLabel} \u2014 destructive] ${t8.description} Requires confirmSite: "${site.name}".`;
+    } else if (t8.destructive) {
+      description = `[${site.name} / ${envLabel} \u2014 destructive] ${t8.description}`;
+    } else {
+      description = `[${site.name} / ${site.environment}] ${t8.description}`;
+    }
+    let inputSchema = t8.inputSchema;
+    if (isProdDestructive) {
+      const cloned = JSON.parse(JSON.stringify(t8.inputSchema));
+      const props = cloned.properties ?? {};
+      props["confirmSite"] = {
+        type: "string",
+        const: site.name,
+        description: `Must equal "${site.name}" to confirm this destructive operation on the production site.`
+      };
+      cloned.properties = props;
+      const existing = cloned.required ?? [];
+      cloned.required = ["confirmSite", ...existing];
+      inputSchema = cloned;
+    }
+    return { name: t8.name, description, inputSchema };
+  });
+}
+function assertConfirmSite(tool, args, site) {
+  if (!site || site.environment !== "prod" || !tool.destructive) return;
+  if (args["confirmSite"] !== site.name) {
+    throw new Error(
+      `confirmSite mismatch: expected "${site.name}", got ${JSON.stringify(args["confirmSite"])}. Pass confirmSite: "${site.name}" to confirm this destructive operation on the production site.`
+    );
+  }
+}
+function wrapResult(result, site) {
+  if (!site) return result;
+  return { site, result };
+}
+
 // src/server.ts
 async function startServer(config2) {
   const auth = new CognitoAuth(config2);
@@ -32179,18 +32266,15 @@ async function startServer(config2) {
   };
   const ctx = {
     graphql,
-    storage
+    storage,
+    site: config2.site
   };
   const server = new Server(
-    { name: "@ampless/mcp-server", version: "0.0.1" },
+    { name: buildServerName(config2.site), version: "0.0.1" },
     { capabilities: { tools: {} } }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: tools.map((t8) => ({
-      name: t8.name,
-      description: t8.description,
-      inputSchema: t8.inputSchema
-    }))
+    tools: decorateToolListing(tools, config2.site)
   }));
   server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const tool = tools.find((t8) => t8.name === request.params.name);
@@ -32198,12 +32282,12 @@ async function startServer(config2) {
       throw new Error(`Unknown tool: ${request.params.name}`);
     }
     try {
-      const result = await tool.handler(
-        request.params.arguments ?? {},
-        ctx
-      );
+      const args = { ...request.params.arguments ?? {} };
+      assertConfirmSite(tool, args, config2.site);
+      delete args["confirmSite"];
+      const result = await tool.handler(args, ctx);
       return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+        content: [{ type: "text", text: JSON.stringify(wrapResult(result, config2.site), null, 2) }]
       };
     } catch (err) {
       return {

package/dist/tools/index.d.ts

@@ -1,5 +1,12 @@
 import { BundleExtractResult } from 'ampless';
 
+interface ResolvedSite {
+    name: string;
+    url?: string;
+    environment: 'prod' | 'stg' | 'dev';
+    siteId: string;
+}
+
 /**
  * Abstract contracts each tool handler depends on. Concrete
  * implementations live elsewhere:
@@ -48,6 +55,7 @@ interface StorageClient {
 interface ToolContext {
     graphql: GraphqlClient;
     storage: () => StorageClient;
+    site?: ResolvedSite;
 }
 
 /**
@@ -100,6 +108,7 @@ interface ToolDefinition {
     description: string;
     inputSchema: Record<string, unknown>;
     handler: (args: Record<string, unknown>, ctx: ToolContext) => Promise<unknown>;
+    destructive?: boolean;
 }
 declare const tools: ToolDefinition[];
 /**

package/dist/tools/index.js

@@ -5,7 +5,7 @@ import {
   extractZipFromBuffer,
   getTools,
   tools
-} from "../chunk-K4GTND6P.js";
+} from "../chunk-HVSLKTKC.js";
 import "../chunk-LMMQX4CK.js";
 export {
   decodeUtf8,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampless/mcp-server",
-  "version": "1.0.0-alpha.14",
+  "version": "1.0.0-alpha.16",
   "description": "MCP server for ampless — lets AI agents (Claude Desktop, Cursor, Claude Code) read and write posts and media via AppSync",
   "license": "MIT",
   "type": "module",
@@ -36,7 +36,7 @@
     "@aws-sdk/client-s3": "^3.1053.0",
     "amazon-cognito-identity-js": "^6.3.16",
     "fflate": "^0.8.3",
-    "ampless": "1.0.0-alpha.13"
+    "ampless": "1.0.0-alpha.14"
   },
   "keywords": [
     "ampless",