mcp-magento-cms 1.0.0

package/.env.example

@@ -0,0 +1,11 @@
+# Magento (ddev or remote) — no trailing slash
+MAGENTO_BASE_URL=https://mage248p3.ddev.site
+
+# Integration Access Token from Admin → System → Integrations
+MAGENTO_ACCESS_TOKEN=
+
+# Optional store code for REST (default: all / empty uses /rest/V1)
+# MAGENTO_STORE_CODE=default
+
+# Optional admin path prefix for edit links (default: admin)
+# MAGENTO_ADMIN_PATH=admin

package/README.md

@@ -0,0 +1,149 @@
+# Magento CMS MCP (Cursor) — zero npm dependencies
+
+Create/update Magento **CMS Pages / Blocks** with Page Builder **Row → Text**.
+
+- **AI:** your Cursor subscription (chat plans content)
+- **This server:** Magento REST only (Integration Access Token)
+
+Requires **Node 18+** only (`fetch` built-in). No `npm install` required.
+
+## Tools
+
+| Tool | Purpose |
+|------|---------|
+| `magento_health` | Test base URL + token |
+| `get_cms_page` | Load by `page_id` |
+| `create_cms_page` | Create from title + content |
+| `update_cms_page` | Update by `page_id` (e.g. 8) |
+| `get_cms_block` / `create_cms_block` / `update_cms_block` | Blocks |
+| `list_section_types` | Supported layouts (MVP: simple_text) |
+
+## Setup
+
+### 1. Magento Integration token
+
+Automated (recommended, ddev):
+
+```bash
+ddev exec php tools/mcp-magento-cms/scripts/create-integration.php
+# prints ACCESS_TOKEN=... (idempotent; reuses the "MCP CMS Studio" integration)
+```
+
+Or manually: Admin → **System → Extensions → Integrations** → Add New Integration →
+API tab: allow **CMS Pages/Blocks** and **Content → Design (save_design)** → Save → Activate → copy Access Token.
+
+Magento 2.4.4+ blocks integration tokens as bearer by default. Enable once:
+
+```bash
+ddev exec bin/magento config:set oauth/consumer/enable_integration_as_bearer 1
+ddev exec bin/magento cache:flush config
+```
+
+### 2. Base URL (ddev)
+
+```bash
+ddev describe
+# e.g. https://mage248p3.ddev.site
+```
+
+### 3. Configure `.env`
+
+```bash
+cd tools/mcp-magento-cms
+cp .env.example .env
+# set:
+# MAGENTO_BASE_URL=https://YOUR-PROJECT.ddev.site
+# MAGENTO_ACCESS_TOKEN=your_access_token
+```
+
+Test without Cursor (optional):
+
+```bash
+# ddev uses a mkcert TLS cert that Node does not trust by default:
+export NODE_EXTRA_CA_CERTS="$HOME/.local/share/mkcert/rootCA.pem"
+
+# only works when Magento is up and token is set
+node scripts/health-check.js
+
+# full end-to-end: creates a real Page Builder CMS page and reads it back
+node scripts/smoke-e2e.js
+
+# local compose smoke test (no Magento):
+node scripts/test-compose.js
+```
+
+### 4. Cursor MCP config
+
+**Cursor → Settings → MCP**, or project file `.cursor/mcp.json`:
+
+Use **absolute** path to `index.js`:
+
+```json
+{
+  "mcpServers": {
+    "magento-cms": {
+      "command": "node",
+      "args": [
+        "/home/YOUR_USER/htdocs/mage248p3/tools/mcp-magento-cms/src/index.js"
+      ]
+    }
+  }
+}
+```
+
+Secrets can stay in `.env` next to the server (auto-loaded). Or pass env:
+
+```json
+{
+  "mcpServers": {
+    "magento-cms": {
+      "command": "node",
+      "args": [
+        "/ABSOLUTE/PATH/tools/mcp-magento-cms/src/index.js"
+      ],
+      "env": {
+        "MAGENTO_BASE_URL": "https://mage248p3.ddev.site",
+        "MAGENTO_ACCESS_TOKEN": "YOUR_TOKEN"
+      }
+    }
+  }
+}
+```
+
+See also `cursor-mcp.example.json`. Restart MCP / Cursor after changes.
+
+## Prompts to try
+
+```text
+Use magento_health to verify Magento.
+```
+
+```text
+Create a CMS page titled "MCP Demo" with this content:
+First paragraph from Google Docs.
+Second paragraph.
+```
+
+```text
+Update CMS page_id 8 with content: Updated body for page 8.
+```
+
+## Security
+
+- Do not commit `.env` or tokens
+- Integration token should only have CMS permissions
+
+## Layout
+
+```
+tools/mcp-magento-cms/
+  src/index.js                    MCP server (stdio)
+  src/magentoClient.js            REST client
+  src/pageBuilder.js              Row → Text HTML
+  .env.example
+  scripts/create-integration.php  Create integration + token (run via ddev exec)
+  scripts/health-check.js
+  scripts/smoke-e2e.js            End-to-end page creation test
+  scripts/test-compose.js
+  samples/                        Exported reference pages (Page Builder HTML)
+```

package/cursor-mcp.example.json

@@ -0,0 +1,15 @@
+{
+  "mcpServers": {
+    "magento-cms": {
+      "command": "node",
+      "args": [
+        "/home/ajaykumar.prajapati@brainvire.com/htdocs/mage248p3/tools/mcp-magento-cms/src/index.js"
+      ],
+      "env": {
+        "MAGENTO_BASE_URL": "https://mage248p3.ddev.site",
+        "MAGENTO_ACCESS_TOKEN": "REPLACE_WITH_INTEGRATION_ACCESS_TOKEN",
+        "NODE_EXTRA_CA_CERTS": "/home/ajaykumar.prajapati@brainvire.com/.local/share/mkcert/rootCA.pem"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "mcp-magento-cms",
+  "version": "1.0.0",
+  "description": "Cursor MCP: Magento CMS pages/blocks with Page Builder Row→Text (zero npm deps)",
+  "type": "module",
+  "main": "src/index.js",
+  "scripts": {
+    "start": "node src/index.js",
+    "health": "node scripts/health-check.js",
+    "test:compose": "node scripts/test-compose.js"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}