Royal Mcp

---

Royal MCP 是一个开源 WordPress 插件，可将你的网站变为 Model Context Protocol 服务。只需连接一次，你的 AI 应用就能像你在 wp-admin 中操作那样读取和更改网站内容：文章、页面、媒体、菜单、WooCommerce 商店、Elementor 和 Divi 页面、SEO、备份和安全。每次调用都以 WordPress 用户身份执行，并根据该用户的权限进行检查，同时记录在活动日志中；所有破坏性更改都可以撤销。

所有内容都不会经由第三方服务转发。你的 API 密钥、登录令牌和日志都保存在自己的 WordPress 数据库中。

你可以用它做什么

用日常语言提出要求。以下功能在免费插件中都可用：

向 AI 提出要求……	结果
“为我们的春季促销写一篇文章草稿，用这张图片作为特色图片，并撰写 SEO 标题和描述。”	创建文章草稿，将图片上传到媒体库，设置特色图片，并为 Yoast、Rank Math、AIOSEO 或 SEOPress 编写元数据。发布前不会上线。
“找出仍提到我们旧电话号码的页面并更新它们。”	搜索你的内容并逐页替换文本，每项更改都会生成一个撤销令牌。
“哪些商品库存偏低？创建一张满 100 美元减 15% 的优惠券。”	按库存状态筛选并读取商品，然后创建 WooCommerce 优惠券。
“将 Services 页面克隆为新的落地页，更改标题并替换主视觉图片。”	克隆 Elementor 页面，并原位编辑文案和图片，同时保留原有布局。
“显示本月访问量最高的页面和搜索查询。”	从 MonsterInsights 读取概览、热门页面、流量来源和 Search Console 查询。
“创建备份，然后检查本周是否有存在漏洞的插件和登录失败记录。”	启动备份（SiteVault 或 UpdraftPlus），并读取扫描结果和登录活动（GuardPress、Wordfence 或 Solid Security）。
“网站感觉很慢。是什么问题？”	读取网站状态、PHP 错误日志和 cron 计划；问题修复后清除缓存（ForgeCache、LiteSpeed Cache 或 W3 Total Cache）。
“撤销上一项更改。”	在 72 小时内，根据保存的快照还原最近一次破坏性写入。

专为与其他 MCP 工具协同工作而打造

Royal MCP 的设计目标是与其他插件提供的 MCP 工具并行运行，让 AI 能为任务的每个环节选择最合适的工具。

• Elementor。 启用 Elementor 自带的 MCP 后，Royal MCP 会检测到它，并告知 AI：Elementor 的构建器可用于设计新布局。Royal MCP 的 Elementor 工具则继续负责编辑现有页面，包括替换文本和图片、处理小工具、克隆页面和使用模板。
• WooCommerce。 WooCommerce 自带的 MCP 功能会继续运行。Royal MCP 则补充商店的其他功能：优惠券、变体、属性、客户和商店统计数据。
• WordPress Abilities API。 Royal MCP 的工具也会注册为 WordPress abilities。安装 MCP Adapter 后，这些工具会通过 Royal MCP 自己的适配器服务 royal-mcp-server 提供，并沿用原生端点的权限检查、开关和日志记录。

Royal MCP 通过自己的端点响应，绝不会关闭其他插件的工具，因此组合使用能覆盖网站的更多功能，而不是各自单独使用。

安全性

• AI 应用会先征求你的同意。 默认情况下，Claude、ChatGPT 和其他客户端会要求你批准每次破坏性工具调用。
• 先创建草稿。 新文章和页面会先以草稿形式创建。
• 只读模式和仅草稿模式。 一个开关即可拒绝所有会更改网站的工具调用，或拒绝所有会发布内容的工具调用。
• 为每个连接单独设置访问级别。 在 Connected Clients 界面中，为每个已连接的 AI 应用设置完全访问、只读或仅草稿访问权限，也可撤销任一权限。
• Recent Changes 和撤销功能。 每次破坏性写入都会先保存快照。Recent Changes 界面会显示更改前、更改后和当前的值；在 72 小时内调用一次 mcp_undo_last_operation 即可撤销更改。
• 活动日志。 每次工具调用都会记录工具名称、参数键、IP 和用户代理。不会保存参数值。
• 试运行。 更改网站选项和固定链接结构等影响较大的写入操作，可在应用前预览。

功能

共 270 个工具：113 个始终可用的核心工具，以及 157 个仅在对应插件启用时加载的集成工具。

WordPress 核心（113 个工具）

• 内容 - 文章、页面和自定义文章类型（创建、读取、更新、删除、克隆为草稿、修订、特色图片）
• 分类体系 - 分类目录、标签、自定义分类法、术语元数据、文章与术语关联
• 媒体 - 浏览；上传图片、PDF 和其他允许的文件（通过 URL、base64，或使用 ChatGPT 传来的文件）；上传时转换、调整大小和压缩图片；按地址或内容查找媒体库中的现有文件并重复使用，避免上传副本；更新元数据；删除
• 区块 - 读取文章的区块树；插入、替换、移动或删除单个区块；跨区块替换文本；读取和编辑同步模式；读取全局样式和站点编辑器模板
• 评论 - 创建和审核（批准、标记为垃圾评论、移至回收站）
• 用户 - 显示名称、角色、注册日期，以及用户角色之外获授的任何权限。除非网站所有者通过 royal_mcp_user_fields 过滤器选择公开，否则不会显示电子邮件和用户名
• 菜单 - 读取、创建菜单项、重新排序、更新
• 主题 - 自定义 CSS、主题修改项、启用的主题
• 站点 - 固定链接结构、允许列表中的选项、站点信息
• 搜索 - 跨内容搜索
• SEO - 读取和写入 Yoast、Rank Math、AIOSEO、SEOPress 和 SEObolt 的元数据
• 安全性 - 只读模式、仅草稿模式、逐连接访问级别、Recent Changes 和 72 小时撤销功能
• 插件和主题 - 所有已安装的插件，包括必须使用的插件和 drop-in 插件，以及版本、启用状态和最后修改日期；已安装的主题
• 诊断 - 站点状态（一次调用即可查看 WordPress、PHP、MySQL、插件、主题和 cron）；PHP 错误日志末尾内容；cron 计划；以及 royal_mcp_connection_health

插件集成（157 个工具）

插件	工具数	覆盖范围
WooCommerce	29	产品、变体、属性、优惠券、订单（创建、更新、备注）、客户、商店统计数据；支持带总数的分页列表；按 ID、SKU 和库存状态筛选产品；按日期筛选订单
Elementor	14	克隆页面、替换文本、替换图片、页面大纲、小工具设置、添加小工具、模板（列表、导入、应用）、小工具架构、动态标签、重建文章内容
Divi	9	格式检测（Divi 4 或 Divi 5）、页面大纲、布局验证、库列表和读取、查找和替换、克隆、替换图片、应用库项目
Wordfence	8	安全状态、防火墙模式和扫描发现项、被封锁的 IP、封锁或解除封锁 IP、登录失败记录、被封锁的请求、启动扫描
GuardPress	7	安全评分、登录失败记录、被封锁的 IP、漏洞扫描、审计日志
SiteVault	6	启动备份、监控进度、列出备份和计划
Royal AI Firewall	6	仪表板统计数据、近期机器人访问记录、逐个机器人设置策略（允许、封锁、质询）、每日汇总数据
TablePress	6	列出、读取、创建、复制和导出表格，修改单元格并支持撤销
Yoast SEO	5	元数据读取和写入、JSON-LD 架构图、已索引的内部链接、Premium 重定向
Code Snippets	5	列出和读取代码片段（代码中的凭据会屏蔽）、近期停用记录、停用代码片段、编辑其名称、描述和标签
Redirection	4	列出、创建和更新重定向；列出分组
Royal Ledger	4	软件成本、续订日期、许可证密钥（绝不公开其值）
Advanced Custom Fields	4	读取和写入字段，并遵循各字段的 Return Format；列出字段组
UpdraftPlus	4	备份历史记录、逐个备份的状态、启动备份、计划
WPForms	4	表单、表单字段、提交内容（WPForms Pro）
Solid Security	4	安全状态、被锁定的 IP、安全日志、封禁 IP
MonsterInsights	4	分析概览、热门页面、流量来源、热门 Search Console 查询
BuddyPress	4	成员、成员资料、群组、动态信息流（也支持 BuddyBoss Platform）
LiteSpeed Cache	4	缓存状态和设置、清除全部缓存或指定页面的缓存
ForgeCache	4	缓存统计数据、清除缓存、清除指定 URL 的缓存、真实用户的 Core Web Vitals
Contact Form 7	3	表单、表单字段、提交内容（需配合 Flamingo）
W3 Total Cache	3	缓存配置、清除缓存（全部、按 URL 或按文章）、用量统计
Duplicator	3	迁移包、包状态、安装程序 URL
Complianz	7	同意设置状态、Cookie、服务、横幅文本和法律文档；更改横幅文本和 Cookie 描述并支持撤销
WPCode	3	只读：代码片段、代码片段（凭据已屏蔽）、其状态和最近的错误
Royal Links	3	品牌短链接、点击统计

没找到你使用的插件？核心工具仍可处理任何自定义文章类型的文章、通过文章元数据处理任何插件的自定义字段，以及处理任何插件的评论。请在 WordPress.org 支持论坛申请集成。如果你开发了该插件，可以自行将其工具添加到 Royal MCP，也可以与我们合作。

连接

安装

1. 从 WordPress.org 安装（推荐，可通过 wp-admin 接收更新），或上传最新 GitHub 版本中的 zip 文件。
2. 前往 Royal MCP → 设置，启用 Royal MCP 并复制 MCP 服务 URL。对于使用 API 密钥的客户端，请在同一页面生成密钥。
3. 选择下方的客户端。

你的 MCP 服务 URL 为 https://yoursite.com/wp-json/royal-mcp/v1/mcp。

Claude（claude.ai、Claude Desktop）- 使用 OAuth 登录

1. Settings → Connectors → Add custom connector。
2. 粘贴 MCP 服务 URL。
3. 在你的网站上批准登录页面。无需 API 密钥。

ChatGPT

添加自定义连接器，填入 MCP 服务 URL，然后按照登录流程操作。

使用 API 密钥的 Claude Desktop

{
  "mcpServers": {
    "my-wordpress": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://yoursite.com/wp-json/royal-mcp/v1/mcp",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}

配置文件：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）。

Cursor、VS Code、Claude Code 和其他 MCP 客户端

添加 HTTP MCP 服务，将 MCP 服务 URL 和设为 Bearer YOUR_API_KEY 的 Authorization 标头填入，或者在客户端支持的情况下使用 OAuth。

原始 HTTP

# 1. Start a session. -i prints the headers so you can copy Mcp-Session-Id.
curl -i -X POST https://yoursite.com/wp-json/royal-mcp/v1/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "initialize",
    "id": 1,
    "params": {
      "protocolVersion": "2025-11-25",
      "capabilities": {},
      "clientInfo": {"name": "my-app", "version": "1.0"}
    }
  }'

# 2. List the tools, using the session id from the response headers.
curl -X POST https://yoursite.com/wp-json/royal-mcp/v1/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Mcp-Session-Id: <session_id>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 2}'

旧版 X-Royal-MCP-API-Key 标头在此版本中仍然有效，但已弃用。请改用 Authorization: Bearer 发送密钥。

安全模型

层级	作用
API 密钥	由加密安全的生成器生成的 32 位十六进制字符，仅以 SHA-256 哈希形式存储，并通过恒定时间比较进行验证。通过 Authorization: Bearer 发送。可从 wp-admin 或使用 wp royal-mcp rotate-api-key 轮换。
OAuth 2.1	动态客户端注册（RFC 7591）、授权服务器元数据（RFC 8414）、必须使用 PKCE S256、刷新令牌。不支持隐式授权和客户端凭据授权。
功能检查	每个工具都会检查所需的 WordPress 功能权限，例如，创建或更新内容需要 edit_posts，特定文章需要 edit_post，站点设置需要 manage_options。
速率限制	按 IP 计，每分钟：无凭据时 60 个请求，有凭据时 300 个请求。通过 WordPress Abilities API 和其他 MCP 服务发出的调用：每位用户每分钟 300 个请求。
会话	使用加密安全的随机会话 ID，有效期为滚动续期的 24 小时。
活动日志	每次工具调用记录一行：工具名称、参数键、IP、用户代理和错误。绝不存储参数值。
已连接的客户端	查看每个已登录的 AI 应用，设置其访问级别，并撤销单个或全部客户端的访问权限。一键重置可清除 OAuth 客户端和令牌，不影响 API 密钥或设置。
发现	站点根目录下的 .well-known/oauth-authorization-server 和 .well-known/oauth-protected-resource（RFC 8414、RFC 9728）。

发现安全问题？请通过 royalplugins.com/contact 私下报告，不要在公开的问题区发布。

Royal MCP Pro

**Royal MCP 为单个站点所有者提供安全的 AI 连接。Royal MCP Pro 适用于在实际客户项目中运行 AI：**提供 350 多个工具，可对多个页面和产品进行批量操作，支持更深入的 Elementor、Divi、WooCommerce 和 ACF 内容创作，通过跨插件工作流一次调用即可完成整项工作，并提供完整的审计追踪。

Pro 是一个包含 Royal MCP 全部功能的插件。启用 Pro 后，只需单独运行 Pro。

	Royal MCP（免费版）	Royal MCP Pro
工具	270	350+
连接 Claude、ChatGPT、Cursor 和任何 MCP 应用（OAuth 或 API 密钥）	✅	✅
只读和仅草稿模式、按连接设置访问级别	✅	✅
针对破坏性写入的近期更改记录和 72 小时撤销功能	✅	✅ Pro 工具也适用
每次工具调用的活动日志	✅	✅
通用审计日志，支持筛选、逐条撤销、CSV 导出和保留 90 天	—	✅
自定义端点配置：选择每个 AI 连接可调用的工具	—	✅
对文章进行批量查找和替换，分两步提交	—	✅
Elementor：克隆、编辑文本和图片、添加小工具、应用模板	✅ 14 个工具	✅
深入支持 Elementor Pro：按 ID 对小工具、容器和区段进行 CRUD 操作，支持 Theme Builder 和显示条件、批量小工具设置、全局变量和类	—	✅ +14 个工具
WooCommerce：产品、变体、属性、优惠券、订单、客户、统计数据	✅ 29 个工具	✅
WooCommerce 批量操作：价格、库存、分类、订单状态、带确认步骤的删除、分组产品、批量优惠券	—	✅ +12 个工具
Divi：大纲、验证、查找和替换、克隆、替换图片	✅ 9 个工具	✅
Divi Pro：创建、更新和删除库内容，Divi 4 到 Divi 5 迁移器，批量应用全局预设	—	✅
ACF：读取和写入字段值	✅ 4 个工具	✅
ACF 设置套件：字段组、字段、JSON 导入和导出、选项页面、文章类型和区块	—	✅ +15 个工具
SEO：按文章读取和写入元数据	✅	✅
SEO 代理套件：全站 SEO 审核和批量元数据写入工具	—	✅
跨插件工作流：发布就绪检查、每月维护报告、主题更换时迁移资源、一次调用即可启动 SEO 并支持回滚	—	✅
FormForge Pro 条目、分析和表单创建	—	✅
Royal Affiliate Pro 联盟会员、推荐、活动和付款	—	✅ +25 个工具
站点数量	不限	1、5 或 100 个
更新	WordPress.org	直接来自 Royal Plugins
支持	WordPress.org 论坛和 GitHub Issues	电子邮件支持
价格	永久免费	每年 $99 起 · 30 天退款保证

了解 Royal MCP Pro → · 价格 · 免费版与 Pro 完整对比

范围

Royal MCP 有意不提供以下功能：

• **不更改核心文件。**它绝不会写入 wp-content/themes、wp-includes 或 wp-admin。
• **不安装或升级插件。**它可以列出插件，但不会安装、启用或更新插件。
• **不执行原始 SQL。**所有查询都通过 WordPress API 和预处理语句执行。
• **免费插件不提供 Elementor Theme Builder 模板。**Theme Builder 功能包含在 Royal MCP Pro 中。
• **不写入 Beaver Builder 或 Bricks 布局 JSON。**可读写其标准文章内容；除非有专用工具支持，否则不会处理构建器专属的布局数据。

Royal Plugins 的更多插件

Royal MCP 可与 Royal Plugins 系列中的其他插件协同工作。每个插件处于启用状态时，都会为 Royal MCP 添加自己的工具。

插件	功能
Royal MCP Pro	为代理机构提供 350 多种工具：批量操作、深入的构建器与商店内容编辑、审计日志
GuardPress	安全功能：防火墙、恶意软件扫描器、双重身份验证、登录保护、活动日志
SiteVault	自动备份、暂存环境、加密、迁移（免费版本）
ForgeCache	页面缓存、CSS 和 JS 优化、延迟加载、CDN、Core Web Vitals
SEObolt	SEO 审核、排名跟踪、结构化数据、重定向、图片 SEO
FormForge	表单构建器，支持条件逻辑、付款、测验和 PDF 导出
Royal Affiliates	在 WooCommerce 上运行自己的联盟营销计划
Royal Links	品牌链接，支持地理定位、A/B 测试和点击分析（免费版本）
Royal AI Firewall	免费：查看并控制访问你网站的 AI 机器人
Royal SMTP	免费：通过 SMTP 可靠地发送电子邮件
Royal Access	免费：角色与权限管理

通过 Royal Plugins 获利

向你的受众推荐 Royal MCP Pro 和系列中的其他插件，每笔首年销售可赚取 30%，每笔续订可赚取 15%，并享有 60 天 Cookie 跟踪期和每月付款。

加入 Royal Plugins 联盟计划 →

延伸阅读

• 5 分钟内将 Claude 连接到 WordPress - 快速完成连接，附有视频和分步设置说明。
• 使用 Claude 编辑 Elementor：4 种实用工作流 - 介绍使用 AI 编辑 Elementor 页面的方法，以及何时使用每种方法，附有提示词、示例和视频演示。
• 使用 Claude + DeepL MCP 翻译 WordPress - 展示 Royal MCP 与另一个 MCP 服务如何协作完成实际任务。
• WordPress 的 MCP 时代：分发服务器与运行时服务器如今并存 - 说明为什么在同一个网站上使用多个 MCP 工具能更好地协同工作。
• 适用于 WordPress 的 Claude Skills - 将你反复使用的提示词转化为可复用的工作流。

许可证

GPLv2 或更高版本。请参阅 LICENSE 或 GNU 网站。

Royal MCP 按“原样”提供。API 密钥可保护你的端点；请像保护其他凭据一样妥善保管。对于任何 AI 平台获准在你的 WordPress 网站上执行的内容、命令和操作，你均须承担责任。

---

由 Royal Plugins 打造
轻量、以安全为先的 WordPress 插件。
© 2026 Royal Plugins。