[𝍋 MCP Server Tool] Add pwa-kit-create-app guideline tool @@W-18812373@@

packages/pwa-storefront-mcp/CHANGELOG.md

@@ -0,0 +1,2 @@
+## v1.0.0-dev.0 (Jun 26, 2025)
+- Add `pwa-kit-create-app` guideline tool  [#2663](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2663)

packages/pwa-storefront-mcp/package.json

@@ -31,6 +31,7 @@
   "dependencies": {
     "@babel/runtime": "^7.21.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "@salesforce/pwa-kit-create-app": "3.11.0-dev.0",
     "zod": "^3.25.56"
   },
   "devDependencies": {

packages/pwa-storefront-mcp/src/server/server.js

@@ -14,8 +14,7 @@ import {CreateNewComponentTool} from '../utils/CreateNewComponentTool.js'
 import fs from 'fs/promises'
 import path from 'path'
 import {fileURLToPath} from 'url'
-import {DeveloperGuidelinesTool} from '../utils/pwa-developer-guideline-tool.js'
-
+import {CreateProjectTool, DeveloperGuidelinesTool} from '../utils/index.js'
 class PwaStorefrontMCPServerHighLevel {
     constructor() {
         // Using McpServer instead of Server
@@ -38,6 +37,15 @@ class PwaStorefrontMCPServerHighLevel {
     }
 
     setupTools() {
+
+        // Register CreateProjectTool
+        this.server.tool(
+            CreateProjectTool.name,
+            CreateProjectTool.description,
+            CreateProjectTool.inputSchema,
+            CreateProjectTool.fn
+        )
+
         // Register DeveloperGuidelinesTool
         this.server.tool(
             DeveloperGuidelinesTool.name,

packages/pwa-storefront-mcp/src/utils/index.js

@@ -0,0 +1,10 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import CreateProjectTool from './pwa-create-app-guideline-tool.js'
+import DeveloperGuidelinesTool from './pwa-developer-guideline-tool.js'
+
+export {CreateProjectTool, DeveloperGuidelinesTool}

packages/pwa-storefront-mcp/src/utils/pwa-create-app-guideline-tool.js

@@ -0,0 +1,82 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+// First party dependencies
+import CREATE_APP_SCHEMA from '@salesforce/pwa-kit-create-app/program.json' assert { type: 'json' }
+
+// Project dependencies
+import {EmptyJsonSchema} from './utils.js'
+
+
+const guidelinesDescription = `
+# PWA Kit Create App — Agent Usage Guidelines
+
+## Overview
+
+This document defines the behavior agents must follow when using the \`@salesforce/pwa-kit-create-app\` CLI tool to generate new PWA Kit projects. The CLI supports both **presets** and **templates** for project creation, and agents must clearly distinguish between these two modes of operation.
+
+---
+
+## General Rules
+
+- Always use this tool to initiate project creation. Never attempt to manually create a project outside of this process.
+- Ask one question at a time when gathering information from the user.
+- Do not mix presets and templates. Only show or ask about one based on the user's intent.
+- Never proceed with project generation unless all required information has been collected.
+
+---
+
+## Creating a Project Using a Preset
+
+If the user requests a project using a **preset**:
+
+- List only the available presets.
+- If a preset is provided, use the \`--preset\` flag with the CLI.
+- Do not ask for or display any template options.
+
+---
+
+## Creating a Project Using a Template
+
+If the user requests a project using a **template**:
+
+- List only the available templates.
+- If a template is provided:
+  - Use its associated questions to prompt the user, one at a time.
+  - Do not proceed with project generation until all required answers have been collected.
+- Do not ask for or display any preset options.
+
+---
+
+## Important Reminders
+
+- Never attempt to create a project without using this tool.
+- When gathering answers for a template, ask questions one at a time to maintain clarity.
+- Presets and templates are mutually exclusive paths. Do not offer both options unless explicitly requested.
+`
+
+export default {
+    name: 'create-app_guidelines',
+    description: guidelinesText,
+    description: `This tool is used to provide the agent with the instructions on how to use the @salesforce/pwa-kit-create-app CLI tool to create a new PWA Kit projects. Do not attempt to create a project without using this tool first.`,
+    inputSchema: EmptyJsonSchema,
+    fn: async () => ({
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(
+                {
+                    guidelines: guidelinesText,
+                    cli: CREATE_APP_SCHEMA.metadata.description,
+                    schemas: {...CREATE_APP_SCHEMA.schemas},
+                    data: {...CREATE_APP_SCHEMA.data}
+                },
+                null,
+                2
+            )}
+        ]
+    })
+}

packages/pwa-storefront-mcp/src/utils/pwa-developer-guideline-tool.js

@@ -105,7 +105,7 @@ This document offers guidelines in the development of Salesforce Commerce Compos
 - Follow security best practices for all code.
 `
 
-export const DeveloperGuidelinesTool = {
+export default {
     name: 'development_guidelines',
     description: `You must follow this development guidelines before attempting to analyze/ generate / refactor / modify / fix code.
     - e.g. "Create a customer service Chat component", "Find bugs in my_script.jsx", "Refactor my_script.jsx to use React Hooks"`,