@salesforce/pwa-kit-mcp 0.2.1-dev → 0.3.0-dev

package/CHANGELOG.md

@@ -1,4 +1,7 @@
-## v0.2.1-dev (Aug 11, 2025)
+## v0.3.0-dev (Sep 4, 2025)
+
+## v0.2.0 (Sep 4, 2025)
+- Normalize tool names; Add introduction section for PWA Kit MCP and resize the images on README. [#3239](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3239)
 
 ## v0.1.1 (Aug 11, 2025)
 - Add missing `shelljs` dependency. [#3053](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3053)
@@ -9,4 +12,4 @@
 - Add `create_new_sample_component` MCP tool. [#2651](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2651)
 - Add `create_app_guidelines` MCP tool. [#2599](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2599)
 - Add `run_site_test` MCP tool [#2989](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2989) [#2645](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2645) [#3003](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3003)
-- Add `create_sample_storefront_page` MCP tool [#2899](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2899) [#3014](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3014)
+- Add `create_sample_storefront_page` MCP tool [#2899](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2899) [#3014](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/3014)

package/README.md

@@ -12,17 +12,22 @@ It allows AI agents to query context-aware services like this server to help dev
 👉 **[Read more at modelcontextprotocol.io](https://modelcontextprotocol.io/)**
 
 
+## What is PWA-Kit-MCP?
+
+PWA-Kit-MCP is a local STDIO MCP Server that communicates via STDIO and operates in conjunction with a running local process, making it a fully locally installed MCP server. It provides an initial suite of MCP tools intended to standardize and optimize the developer workflow for PWA Kit storefront development. These tools facilitate project creation, supply development guidelines, enable the generation of new components and pages, and support site validation through performance and accessibility testing.
+
+
 ## 🧰 Features
 
 The PWA Kit MCP Server offers the following intelligent tools tailored to Salesforce Commerce Cloud PWA development:
 
-* **`create_app_guidelines`**:
+* **`create_storefront_app`**:
   Guides agents and developers through creating a new PWA Kit project with `@salesforce/pwa-kit-create-app`.
 
-* **`create_new_sample_component`**:
+* **`create_sample_component`**:
   Walks developers through a brief Q\&A to scaffold a component using the commerce data model, layout, and structure.
 
-* **`create_sample_storefront_page`**:
+* **`create_sample_page`**:
   Interactive tool to generate a new PWA storefront page with custom routing and components.
 
 * **`development_guidelines`**:
@@ -32,10 +37,6 @@ The PWA Kit MCP Server offers the following intelligent tools tailored to Salesf
   Runs performance and accessibility audits on a provided site URL.
   *Example: `https://pwa-kit.mobify-storefront.com`*
 
-* **`git_version_control`**:
-  Manages the version control of your project using git.
-  If the project is not already a git repo, project files will be committed as a new local git repo together with a basic .gitignore. If the project is already a git repo, just commit the changes in the project.
-
 
 ## ▶️ Running the MCP Server
 
@@ -44,10 +45,10 @@ The PWA Kit MCP Server offers the following intelligent tools tailored to Salesf
 1. Open **Cursor**.
 
 2. Navigate to **Settings > Cursor Settings...**
-![](https://raw.githubusercontent.com/SalesforceCommerceCloud/pwa-kit/refs/heads/develop/packages/pwa-kit-mcp/docs/images/cursor-settings.png)
+<img src="https://raw.githubusercontent.com/SalesforceCommerceCloud/pwa-kit/refs/heads/develop/packages/pwa-kit-mcp/docs/images/cursor-settings.png" alt="Cursor Settings Screenshot" width="50%" />
 
 3. Go to **Tools & Integrations > MCP Tools > New MCP Server**
-![](https://raw.githubusercontent.com/SalesforceCommerceCloud/pwa-kit/refs/heads/develop/packages/pwa-kit-mcp/docs/images/cursor-mcp-tools.png)
+<img src="https://raw.githubusercontent.com/SalesforceCommerceCloud/pwa-kit/refs/heads/develop/packages/pwa-kit-mcp/docs/images/cursor-mcp-tools.png" alt="Cursor MCP Tools Screenshot" width="50%" />
 
 4. Update your `mcp.json` like this (edit the placeholders as needed):
 ```json
@@ -86,7 +87,7 @@ Then send JSON-RPC requests like:
 
 ```json
 {"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}
-{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "create_new_component", "arguments": {}}}
+{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "create_sample_component", "arguments": {}}}
 ```
 
 ---
@@ -127,6 +128,5 @@ the output on "MCP Logs".
 | `package.json` | Node.js dependencies and project scripts                              |
 | `mcp.json`     | MCP client configuration (used by Cursor or other IDEs)               |
 | `src/server/`  | Main server entry point (`server.js`)                                 |
-| `src/tools/`   | Contains all MCP tools like `create-app-guideline`, `site-test`, etc. |
-| `src/utils/`   | Shared utility functions                                              |
-| `
+| `src/tools/`   | Contains all MCP tools like `create-storefront-app`, `site-test`, etc. |
+| `src/utils/`   | Shared utility functions                                              |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/pwa-kit-mcp",
-  "version": "0.2.1-dev",
+  "version": "0.3.0-dev",
   "private": false,
   "description": "MCP server that helps you build Salesforce Commerce Cloud PWA Kit Composable Storefront",
   "main": "dist/server/server.js",
@@ -54,9 +54,9 @@
   "devDependencies": {
     "@babel/node": "^7.22.5",
     "@playwright/test": "^1.49.0",
-    "@salesforce/pwa-kit-dev": "3.12.0-nightly-20250815080223",
+    "@salesforce/pwa-kit-dev": "3.13.0-nightly-20250908080213",
     "cross-env": "^5.2.1",
-    "internal-lib-build": "3.12.0-nightly-20250815080223",
+    "internal-lib-build": "3.13.0-nightly-20250908080213",
     "nodemon": "^2.0.22"
   },
   "engines": {
@@ -66,5 +66,5 @@
   "publishConfig": {
     "directory": "dist"
   },
-  "gitHead": "8375f9303ed8b66ea36a1a419fde333d7d365181"
+  "gitHead": "eb8863fa1c6a466544a049a432c54d41f8d208d8"
 }