Model Context Protocol server for Sitecore

Name: Model Context Protocol server for Sitecore
Author: Antonytm

本地服务

github.com/Antonytm商业与营销522 周前更新

代码仓库

关于 Model Context Protocol server for Sitecore

Sitecore Community MCP 是一个开源 MCP 服务，让 AI Agent 直接读写 Sitecore 内容，适用于 SitecoreAI 与 XM/XP 的开发者和运维人员。它覆盖多个 Sitecore API，并提供工具分组与过滤功能。

主要功能

01提供 121 个工具，涵盖内容、媒体、安全等
02内置三个引导资源，辅助复杂工作流
03覆盖 GraphQL、Item Service 与 SPE 等接口
04支持 SitecoreAI 与 XM/XP 全版本
05通过 TOOL_PROFILE 等变量裁剪工具列表
06支持 npm、Docker 与源码三种运行方式

适用场景

01AI Agent 批量更新 Sitecore 内容项
02根据设计稿辅助搭建页面结构
03诊断 Sitecore 连接问题

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 Sitecore 相关的工具与资源，并实现 2026-07-28 协议版本及较早版本的协商。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "sitecore-server": {
      "command": "npx",
      "args": [
        "-y",
        "@antonytm/mcp-sitecore-server"
      ]
    }
  }
}

启动命令npx -y @antonytm/mcp-sitecore-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@antonytm/mcp-sitecore-server1.3.2stdio

工具

153

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

Sitecore 社区 MCP

此仓库包含 Sitecore 社区 MCP 服务的源代码——这是一个开源的 Model Context Protocol 服务，可让 AI Agent 直接读写 Sitecore，从而免去在 Agent 与 Content Editor 之间复制粘贴的麻烦。

121 个工具，涵盖搜索、查询、创建、读取、更新、删除、媒体、PowerShell、日志记录、安全和演示
三份指南——guide://compose-page、guide://bulk-update 和 guide://diagnose-connection——Agent 可在任务进行中读取的资源：两种常见而复杂的工作流，适合通过此 MCP 完成，还有一个用于自行诊断连接问题的辅助工具。
覆盖四种 Sitecore API：Authoring and Management GraphQL API、Item Service、GraphQL Edge 和 Sitecore PowerShell Extensions
适用于 SitecoreAI 和 Sitecore XM/XP（所有版本），可搭配任何兼容 MCP 的客户端使用
实现 MCP 协议修订版 2026-07-28，并通过相同的工具注册响应较旧的 initialize 握手——可协商降级至 2025-11-25 到 2024-10-07 之间的任一修订版，因此使用任一时期协议的客户端都能看到相同的工具
据报告，效果包括：Figma 到 Sitecore 的工作流提速 5 倍，手动搭建工作量减少约 70%（案例研究）
提供三种运行方式：npm、Docker 或从源代码运行

开始使用 Sitecore 社区 MCP

要运行 Sitecore 社区 MCP 服务，你需要：

Node——最新的长期支持（LTS）版本。
一个 Sitecore XM、XP 或 SitecoreAI 实例。启用哪些部分决定了哪些工具可用：authoring.* 组只需要 Authoring and Management API（通常已在云端启用）和一个令牌；Item Service 和 SPE Remoting 默认关闭，需要通过配置补丁启用。准备 Sitecore 实例介绍了这三项的准备工作，以及如何逐一验证。

将服务添加到 MCP 客户端

将以下条目添加到客户端的服务映射中——Cursor、Claude Code 和大多数其他客户端使用 mcpServers，VS Code 使用 servers——然后填入你自己的端点和凭据：

{
  "mcpServers": {
    "sitecore-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["@antonytm/mcp-sitecore-server@latest"],
      "env": {
        "TRANSPORT": "stdio",
        "GRAPHQL_ENDPOINT": "https://xmcloudcm.localhost/sitecore/api/graph/",
        "GRAPHQL_SCHEMAS": "edge",
        "GRAPHQL_API_KEY": "{6D3F291E-66A5-4703-887A-D549AF83D859}",
        "GRAPHQL_HEADERS": "",
        "ITEM_SERVICE_DOMAIN": "sitecore",
        "ITEM_SERVICE_USERNAME": "admin",
        "ITEM_SERVICE_PASSWORD": "b",
        "ITEM_SERVICE_SERVER_URL": "https://xmcloudcm.localhost/",
        "POWERSHELL_DOMAIN": "sitecore",
        "POWERSHELL_USERNAME": "admin",
        "POWERSHELL_PASSWORD": "b",
        "POWERSHELL_SERVER_URL": "https://xmcloudcm.localhost/",
        "AUTHORING_CLIENT_ID": "",
        "AUTHORING_CLIENT_SECRET": "",
        "TOOL_PROFILE": ""
      }
    }
  }
}

TOOL_PROFILE 接受以逗号分隔的预设列表，并合并每个预设隐藏的内容。每个预设都指明缺失或不需要的内容，而非平台。其中四个预设指明你的实例未提供的 API 接口——no-spe、no-item-service、no-edge-graphql 和 no-authoring-api——因此，缺少其中两个接口的实例可以同时声明。no-account-management 是唯一一个并非针对缺失接口的预设：它会隐藏 12 个用于在 CM 上创建或编辑账户的工具，适用于希望 Agent 完全无法执行此类操作的部署（不影响项目安全设置，以及对账户和角色的读取）：

TOOL_PROFILE=no-spe,no-item-service

no-spe 是影响最大的预设：如果未安装 SPE，或未启用其 remoting 服务，此服务大约四分之三的工具将无法运行；隐藏这些工具后，Agent 每轮就不必再处理它们的 schema。未知名称会报告到 stderr 并被忽略，其余列表仍然有效。

配置中记录了每项设置。Agent 能容纳的工具数量有限，因此在深入使用前，请阅读工具选择，并使用 TOOL_PROFILE、TOOL_GROUPS 和 DISABLED_TOOLS 精简工具范围。

如需在容器中运行服务或从源代码运行，请参阅运行服务。

与 Sitecore Marketer MCP 的比较

Sitecore 自家的 Marketer MCP 是一项托管服务，面向使用 SitecoreAI 的营销人员。此服务是面向开发者的对应方案，在这一点上，它是更强大的工具：

	Sitecore Community MCP	Sitecore Marketer MCP
平台	SitecoreAI 以及 XM/XP，支持所有版本——包括本地 Docker CM	仅支持 SitecoreAI
托管方式	可自托管（npm、Docker、源码）；凭据绝不会离开你的基础设施	由 Sitecore 托管；通过云端 OAuth
功能范围	覆盖完整开发者功能面的 121 个工具：项目、模板、呈现、媒体、安全、索引、日志、发布、GraphQL、原始 PowerShell	营销人员操作：页面、组件、简报、品牌套件、个性化、A/B 测试
备用方案	`run-powershell-script`、原始 Edge GraphQL 和原始 Authoring GraphQL——即使没有某项工具，仍可通过相应能力完成操作	封闭的工具集
布局安全性	`add-rendering-to-placeholder` 会拒绝添加占位符设置禁止的组件，并指出允许列表	写入操作不会根据占位符设置进行验证
工具筛选	`TOOL_GROUPS` / `DISABLED_TOOLS` / `TOOL_PROFILE` 可减少每轮的架构开销	固定的工具列表

二者互为补充，并非只能二选一：Marketer MCP 提供了此服务没有 API 支持的云端营销功能（简报、品牌套件、个性化变体、A/B 测试），而且客户端可以同时连接二者。对于构建、迁移、审计和运营 Sitecore 解决方案，此服务功能更全面。

文档和社区资源

准备 Sitecore 实例 — SPE Remoting、Item Service、GraphQL 密钥，以及用于启用这些功能的配置补丁
运行服务 — npm、Docker、从源码运行，以及两种传输方式
工具参考 — 按 API 功能面分组的所有工具
配置 — 环境变量、传输方式、超时和 TLS
工具选择 — TOOL_GROUPS、DISABLED_TOOLS 和 TOOL_PROFILE
指南 — guide://compose-page、guide://bulk-update 和 guide://diagnose-connection 资源，以及各自的提供时机
Docker 镜像 — 已发布的 Linux 和 Windows 镜像
更新日志 — 2.0 版本的新内容及其破坏性变更

社区资源：

贡献

我们非常感谢社区为修复错误和改进项目所作的贡献。我们欢迎所有推动此服务发展和改进的努力；请阅读下文，了解如何参与。

贡献指南

请阅读我们的贡献指南，了解我们的开发流程、如何提出错误修复和改进建议，以及如何构建、调试和测试你的更改。

许可证

Sitecore Community MCP 使用 Apache 2.0 许可证。

支持

这是一个社区项目，不受 Sitecore 支持。

问题、错误和功能请求： 请在 Antonytm/mcp-sitecore-server/issues 提交问题。
关于 Sitecore 本身的问题： Sitecore Stack Exchange 或 Sitecore Community Slack 会比 GitHub 问题更适合你。