文档索引查询服务器

专为Adobe AEM文档设计的索引和查询服务器,支持智能分类、代码片段提取和相关页面查找。

  • by ns-26
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 ns-26/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

  2. 健康检查: 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)