Aem MCP Server

🚀 AEM MCP 服务器 (aem-mcp-server)

AEM MCP 服务器是一款功能完备的适用于 Adobe Experience Manager (AEM) 的模型上下文协议 (MCP) 服务器。它能与任何 AI 代理实现简单集成，专为希望通过自然语言管理 AEM 的非技术人员设计。

🚀 快速开始

前提条件

• Node.js 18 及以上版本
• 能够访问 AEM 实例（本地或远程）

安装

npm install aem-mcp-server -g

启动服务器

使用默认设置（针对 http://localhost:4502 的 admin:admin 凭证）：

aem-mcp

配置

选项:
      --version  显示版本号                                   [布尔值]
  -H, --host                         [字符串] [默认值: "http://localhost:4502"]
  -u, --user                                         [字符串] [默认值: "admin"]
  -p, --pass                                         [字符串] [默认值: "admin"]
  -i, --id       客户端 ID                                 [字符串] [默认值: ""]
  -s, --secret   客户端密钥                             [字符串] [默认值: ""]
  -m, --mcpPort                                         [数字] [默认值: 8502]
  -h, --help     显示帮助信息                                             [布尔值]

对于 AEMaaCS，使用 clientId 和 clientSecret 进行身份验证。更多信息。 对于自托管的 AEM，使用用户名/密码。默认凭证是 admin:admin。

示例命令

aem-mcp -u=user@domain.com -p=mypass -H=https://author-qa.domain.com

将 AEM MCP 添加到 AI IDE

✨ 主要特性

• 与 AEM 实例进行对话：可进行内容、组件和资产操作。
• 与 AI IDE 集成（如 Cursor、Copilot、Webstorm、VS Code 等）
• 支持 AEMaaCS 和自托管实例
• 基于 TypeScript 的现代 AEM MCP 服务器
• 具备最新 MCP 特性的 REST/JSON-RPC API
• AEM 页面和资产管理：创建、更新、删除、激活、停用和复制页面及资产
• 组件操作：验证、更新、扫描和管理 AEM 组件（包括体验片段）
• 高级搜索：支持 QueryBuilder、全文、模糊和增强页面搜索
• 复制和推出：发布/取消发布内容，将更改推送到语言副本
• 文本和图像提取：从页面（包括片段）中提取所有文本和图像
• 模板和结构发现：列出模板，分析页面/组件结构
• JCR 节点访问：支持旧版和现代节点/内容访问
• AI/LLM 集成：通过 OpenAI、Anthropic、Ollama 或自定义大语言模型为 AEM 提供自然语言接口
• 安全：提供身份验证、基于环境的配置和安全操作默认设置

📦 AI IDE 集成（Cursor、Copilot 等）

AEM MCP 服务器与支持 MCP 协议的现代 AI IDE 和代码编辑器兼容，如 Cursor 和 Copilot（例如在 WebStorm 或 VS Code 中）。

连接方法：

1. 安装并运行 AEM MCP 服务器：按照上述说明操作。
2. 配置 IDE 以连接到 MCP 服务器：
   • 打开 IDE 的 MCP 服务器设置。
   • 添加新服务器，设置如下：
     • 类型：自定义 MCP
     • URL：http://127.0.0.1:8502/mcp
3. 必要时重启 IDE。此时 IDE 能够：
   • 列出、搜索和管理 AEM 内容
   • 运行 MCP 方法（CRUD、搜索、推出等）

基于 AI 的代码编辑器或自定义客户端示例：

{
  "mcpServers": {
    "AEM": {
      "url": "http://127.0.0.1:8502/mcp"
    }
  }
}

💻 使用示例

列出 MyPage 上的所有组件

📚 详细文档

如需详细的 API 文档，请参考 API 文档。

🔗 类似项目

• https://github.com/indrasishbanerjee/aem-mcp-server（本项目的基础）
• https://www.npmjs.com/package/@myea/aem-mcp-handler（上述项目的原始来源）