Ref Demo MCP

Adobe AEM 文档 MCP 服务器

一个专为从 https://main--refdemo--adobe-demopoc.aem.live 索引和查询 Adobe AEM 文档而设计的 MCP（模型上下文协议）服务器。

特点/特性

• 📝 自动索引42+个Adobe AEM文档页面
• 🏷️ 对页面进行分类（创作、表单、动态媒体、发布、区块等）
• 🔍 智能查询系统，用于查找用例和实施指南
• 📊 按类别浏览或在所有文档中搜索
• 提取代码片段和结构化内容
• 🔗 查找相关页面
• 🚀 SSE（服务器发送事件）传输协议

安装

npm install

使用方法

1. 启动服务器：

npm start

1. 服务器将在 http://localhost:3000/sse

1. 健康检查： http://localhost:3000/health

可用工具

1. index_documentation

从硬编码的网站地图中为所有Adobe AEM文档页面创建索引。

示例：

{
  "tool": "index_documentation",
  "arguments": {
    "max_pages": 50,
    "force_reindex": false
  }
}

2. query_use_cases

查询特定用例的文档及实施指南。

示例：

{
  "tool": "query_use_cases",
  "arguments": {
    "query": "How do I create and submit forms in AEM?",
    "category": "forms",
    "max_results": 5
  }
}

3. get_categories

获取所有文档类别及统计数据。

4. browse_category

浏览特定类别（如创作、表单、动态媒体等）中的所有页面。

5. get_page_details

从特定页面获取完整内容、代码示例和结构。

6. find_related_pages

查找与特定文档页面相关的页面。

7. get_indexing_status

检查当前的索引状态。

文档类别

服务器会自动将页面分类为：

• 创作（或编写）内容创作、区块、主题、翻译
• 表格表单创建、人工智能代理、通用编辑器
• 动态媒体动态媒体设置、模板、智能成像
• 出版发布资源，Git设置，AEM配置
• 街区；阻挡物英雄图、卡片、轮播、视频和其他模块
• 跨渠道移动应用与跨渠道体验
• 内容片段内容片段配置
• 搜索搜索功能和语言支持
• 文档编写使用DA进行文档编写
• 设置创建新站点和Git设置
• 其他常见问题解答（FAQs）、发布说明、入门指南

示例查询

• “我如何使用人工智能创建一个表单？”
• “使用Dynamic Media的前提条件是什么？”
• “我如何为我的AEM网站设置Git？”
• “我如何在我的页面上添加一个英雄区块？”
• “这款手机应用有哪些功能？”
• “我该如何翻译我的网站？”

环境变量

• PORT服务器端口（默认：3000）

连接到MCP客户端

Claude 桌面配置

添加到你的 Claude Desktop 配置文件中（~/Library/Application Support/Claude/claude_desktop_config.json （在 macOS 上）：

{
  "mcpServers": {
    "aem-documentation": {
      "command": "node",
      "args": ["/Users/navdeeps/Desktop/refdemo-mcp/index.js"],
      "env": {
        "PORT": "3000"
      }
    }
  }
}

与其他MCP客户端一起使用

连接到以下SSE终端： http://localhost:3000/sse

建筑学

• 交通用于实时通信的服务器发送事件（SSE）
• 存储内存中的映射以实现快速访问
• 爬行礼貌地抓取，请求之间间隔300毫秒
• 分类基于URL模式的自动分类
• 搜索基于文本的相关性评分，采用加权匹配方法

发展

对于带自动重载的开发：

npm run dev

许可证

麻省理工学院（MIT）