SuperAPI AI 工具集

eds-mcp-server

eds-mcp-server 是专为 Adobe Edge Delivery Services(AEM EDS)打造的 MCP 服务器,提供 41 个工具。AI 代理可通过它读取、审计、追踪、监控、修复页面或整站内容,并执行发布与撤销等操作,所有写入操作均支持预览与回滚。除 MCP SDK 外无需额外依赖,适用于任意 EDS 站点。

访问官网

工具介绍

用途

eds-mcp-server 是首个专为 Adobe Edge Delivery Services(EDS)打造的 MCP 服务器,共包含 41 个工具。它让 AI 代理能够运行并改进你的 Edge Delivery 站点:读取内容、审计问题、修复错误、发布并撤销,支持单页面或整站批量操作,且每一次写入都可预览、可回滚。

主要能力

预览、发布与内容管理

提供 eds_preview_page、eds_publish_page、eds_unpublish_page、eds_preview_and_publish、eds_purge_cache、eds_bulk_preview、eds_bulk_publish、eds_get_job_status、eds_search_pages、eds_get_metadata、eds_get_sitemap、eds_get_redirects 等工具,覆盖发布、缓存清除与批量操作。

Document Authoring(DA)源操作

九个工具可直接访问站点的 Document Authoring 源(admin.da.live),即 EDS 站点背后的真实来源,需要 EDS_DA_TOKEN。工具包括:eds_da_list_sources、eds_da_get_source、eds_da_get_versions、eds_da_put_source、eds_da_delete_source、eds_da_copy_source、eds_da_move_source、eds_da_rollback、eds_da_export / eds_da_push。其中 eds_da_export / eds_da_push 让代理无需本地 checkout 或 aem-cli 即可导出整个 DA 子树、操作后再批量推送。eds_da_push 支持 dryRun: true 预览批量编辑结果(创建/更新/未变,含行差异计数),以及 withUndo: true 使写入可逆,返回一个 undo 对象交给 eds_da_rollback 即可恢复先前内容并移除新建文档。

内容审计

eds_audit_site 扫描整站或子树,返回按优先级排序的问题列表,涵盖 SEO(标题/描述缺失、无 H1、被阻止索引)、可访问性(图片无 alt、缺少 landmark、表单输入无标签)、内容新鲜度(超过一年未更新)、sitemap 覆盖,以及在提供域名时基于 Adobe 真实用户数据评估性能(Core Web Vitals)与 404。eds_audit_page 针对单页执行。eds_audit_report 可将审计结果生成 HTML 报告,包含执行摘要、分维度健康评分、按优先级排列的问题与修复建议,并带 Save-as-PDF 按钮;可传入品牌信息进行白标。eds_audit_snapshot 将每次审计评分记录到站点内容中的历史表(默认私有),并显示与上次的变化;eds_audit_trend 生成可分享的 HTML 走势图。eds_audit_monitor 则在自动运行中审计、与上次快照对比并报告 ok / degraded / broken 状态,可通过 webhook 通知 Slack/Discord。

安全修复

eds_fix_metadata 通过编辑 Document Authoring 源修复页面标题、meta 描述与 Open Graph 图片,走与写入工具相同的 dry-run + undo 路径,内容由代理提供,工具以幂等方式写入。eds_bulk_fix_metadata 在一次可逆操作中对整站执行批量修复。eds_fix_redirect 通过向站点重定向表添加 301 规则来修复 404。eds_fix_audit 则是“一键修复”的代理形式,在一次可逆批次中同时应用元数据与重定向修复。

使用方式

仅需三行即可接入。代理调用工具,服务器与实时 EDS 基础设施通信。只读工具(内容、sitemap、元数据)无需凭证。写入工具(预览、发布、缓存)需要 admin token。分析工具需要 EDS_DOMAIN_KEY,DA 源工具需要 EDS_DA_TOKEN。

配置与认证

浏览器登录(交互使用推荐):打开浏览器跳转至 Adobe 的 admin.hlx.page 登录(与 AEM CLI 相同流程)。admin 站点 token 缓存在 ~/.aem/auth-token.json(权限 0600,约 24 小时),自动复用。请使用 Chrome 或 Firefox —— Safari 会阻止本地回调。EDS_API_KEY 作为 CI/自动化及兜底路径,设置时始终优先。获取 token 的方式:在 https://admin.hlx.page/login 登录后,从 DevTools 复制 auth_token cookie 值,或从已验证的 AEM Sidekick 请求中复制 x-auth-token 头。如需持久凭证,可配置站点 API key。

适用场景

适合希望通过 AI 代理自动化管理 Adobe Edge Delivery Services 站点的团队,包括内容发布、批量审计、SEO 与可访问性检查、Core Web Vitals 监控、404 追踪、A/B 实验查看、重定向管理及安全修复等。

限制

  • Document Authoring 工具需要 EDS_DA_TOKEN(Adobe IMS 访问令牌)。
  • 写入工具需要 admin token,分析工具需要 EDS_DOMAIN_KEY。
  • 浏览器登录回调在 Safari 中被阻止。
  • 文档路径默认假设 .html 扩展名(index → index.html)。
  • 服务器基于 TypeScript 与 @modelcontextprotocol/sdk + zod,使用 stdio 传输,需要 Node 18+ 的原生 fetch()。

开发者与许可

由 FocusGTS 构建(Adobe Silver Solution Partner),采用 Apache-2.0 许可,与 Adobe Inc. 无隶属或背书关系。架构遵循 Adobe 的 MCP 约定(源自 adobe-rnd/da-mcp),工具命名规则为 eds_{verb}_{noun}。