aem-mcp-server 1.0.7 → 1.0.9

package/README.md

@@ -47,6 +47,19 @@ npm install aem-mcp-server -g
 aem-mcp
 ```
 
+### Configuration
+```
+Options:
+      --version    Show version number                                      [boolean]
+  -H, --host       Author instance URL [string]    [default: "http://localhost:4502"]
+  -P, --publisher  Publisher instance URL [string] [default: "http://localhost:4503"]
+  -u, --user       Username for authentication            [string] [default: "admin"]
+  -p, --pass       Password for authentication            [string] [default: "admin"]
+  -m, --mcpPort    Port for MCP server                       [number] [default: 3000]
+  -e, --explorer   Enable Swagger API explorer             [boolean] [default: false]
+  -h, --help       Show help                                                [boolean]
+
+```
 ---
 
 ## AI IDE Integration (Cursor, Cline, etc.)
@@ -88,6 +101,13 @@ Sample for AI-based code editors or custom clients:
 @scanPageComponents() /content/path/to/page
 ```
 
+## API Documentation
+
+For detailed API documentation, please refer to the [API Docs](docs/API.md).
+- Enable the API explorer with the `-e` flag to access Swagger UI:
+```aem-mcp -e```
+- Open http://localhost:3000/api-docs to explore the API endpoints.
+
 ## Contribution
 Contributions are welcome! Please open issues or pull requests for bug fixes, features, or documentation improvements.
 

package/dist/aem/aem.config.js

@@ -1,51 +1,50 @@
 "use strict";
-export const DEFAULT_AEM_CONFIG = {
-  contentPaths: {
-    sitesRoot: process.env.AEM_SITES_ROOT || "/content",
-    assetsRoot: process.env.AEM_ASSETS_ROOT || "/content/dam",
-    templatesRoot: process.env.AEM_TEMPLATES_ROOT || "/conf",
-    experienceFragmentsRoot: process.env.AEM_XF_ROOT || "/content/experience-fragments"
-  },
-  replication: {
-    publisherUrls: process.env.AEM_PUBLISHER_URLS?.split(",") || ["http://localhost:4503"],
-    defaultReplicationAgent: process.env.AEM_DEFAULT_AGENT || "publish"
-  },
-  components: {
-    allowedTypes: process.env.AEM_ALLOWED_COMPONENTS?.split(",") || [
-      "text",
-      "image",
-      "hero",
-      "button",
-      "list",
-      "teaser",
-      "carousel"
-    ],
-    defaultProperties: {
-      "jcr:primaryType": "nt:unstructured",
-      "sling:resourceType": "foundation/components/text"
+export function getAEMConfig(config) {
+  return {
+    contentPaths: {
+      sitesRoot: "/content",
+      assetsRoot: "/content/dam",
+      templatesRoot: "/conf",
+      experienceFragmentsRoot: "/content/experience-fragments"
+    },
+    replication: {
+      publisherUrls: config.AEM_PUBLISHER_URLS?.split(",") || ["http://localhost:4503"],
+      defaultReplicationAgent: "publish"
+    },
+    components: {
+      allowedTypes: config.AEM_ALLOWED_COMPONENTS?.split(",") || [
+        "text",
+        "image",
+        "hero",
+        "button",
+        "list",
+        "teaser",
+        "carousel"
+      ],
+      defaultProperties: {
+        "jcr:primaryType": "nt:unstructured",
+        "sling:resourceType": "foundation/components/text"
+      }
+    },
+    queries: {
+      maxLimit: parseInt(config.AEM_QUERY_MAX_LIMIT || "100"),
+      defaultLimit: parseInt(config.AEM_QUERY_DEFAULT_LIMIT || "20"),
+      timeoutMs: parseInt(config.AEM_QUERY_TIMEOUT || "30000")
+    },
+    validation: {
+      maxDepth: parseInt(config.AEM_MAX_DEPTH || "5"),
+      allowedLocales: ["en"]
     }
-  },
-  queries: {
-    maxLimit: parseInt(process.env.AEM_QUERY_MAX_LIMIT || "100"),
-    defaultLimit: parseInt(process.env.AEM_QUERY_DEFAULT_LIMIT || "20"),
-    timeoutMs: parseInt(process.env.AEM_QUERY_TIMEOUT || "30000")
-  },
-  validation: {
-    maxDepth: parseInt(process.env.AEM_MAX_DEPTH || "5"),
-    allowedLocales: ["en"]
-  }
-};
-export function getAEMConfig() {
-  return DEFAULT_AEM_CONFIG;
+  };
 }
-export function isValidContentPath(path, config = DEFAULT_AEM_CONFIG) {
+export function isValidContentPath(path, config) {
   const allowedRoots = Object.values(config.contentPaths);
   return allowedRoots.some((root) => path.startsWith(root));
 }
-export function isValidComponentType(componentType, config = DEFAULT_AEM_CONFIG) {
+export function isValidComponentType(componentType, config) {
   return config.components.allowedTypes.includes(componentType);
 }
-export function isValidLocale(locale, config = DEFAULT_AEM_CONFIG) {
+export function isValidLocale(locale, config) {
   if (!locale) return false;
   const normalized = locale.toLowerCase();
   return config.validation.allowedLocales.some((l) => l.toLowerCase() === normalized || normalized === "en" && l.toLowerCase().startsWith("en"));

package/dist/aem/aem.connector.js

@@ -1,6 +1,5 @@
 "use strict";
 import axios from "axios";
-import dotenv from "dotenv";
 import { getAEMConfig, isValidContentPath, isValidComponentType, isValidLocale } from "./aem.config.js";
 import {
   createAEMError,
@@ -10,14 +9,13 @@ import {
   createSuccessResponse,
   AEM_ERROR_CODES
 } from "./aem.errors.js";
-dotenv.config();
 export class AEMConnector {
   config;
   auth;
   aemConfig;
   constructor(params) {
     this.config = this.loadConfig(params);
-    this.aemConfig = getAEMConfig();
+    this.aemConfig = getAEMConfig({});
     this.auth = {
       username: this.config.aem.serviceUser.username,
       password: this.config.aem.serviceUser.password

package/dist/cli.js

@@ -4,11 +4,11 @@ import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import { startServer } from "./index.js";
 const argv = yargs(hideBin(process.argv)).options({
-  host: { type: "string", default: "http://localhost:4502" },
-  user: { type: "string", default: "admin" },
-  pass: { type: "string", default: "admin" },
-  mcpPort: { type: "number", default: 3e3 },
-  explorer: { type: "boolean", default: false }
+  host: { type: "string", default: "http://localhost:4502", alias: "H" },
+  user: { type: "string", default: "admin", alias: "u" },
+  pass: { type: "string", default: "admin", alias: "p" },
+  mcpPort: { type: "number", default: 3e3, alias: "m" },
+  explorer: { type: "boolean", default: false, alias: "e" }
 }).help().alias("h", "help").parseSync();
 if (argv.help) {
   process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aem-mcp-server",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "AEM Model Context Protocol (MCP) server",
   "private": false,
   "publishConfig": {