Respira for WordPress
这个仓库是什么,不是什么
本仓库是 Respira WordPress MCP 服务器的公开列表。服务器源码以 @respira/wordpress-mcp-server 的形式发布在 npm 上。该包装代码采用 MIT 许可证,欢迎阅读、fork 或自行集成。
该服务器是 Respira WordPress 插件的客户端,而非独立产品。要完成实际工作,它需要:
在您的站点上安装 Respira for WordPress 插件
绑定许可证的有效 Respira API 密钥
该插件不是开源的。 它采用商业许可证分发。可在 respira.press 免费试用,无需信用卡。付费套餐每月 9 欧元起。
简而言之:您通过 npx -y 运行的包装器是开放的。其背后的产品不是,这是有意为之。如果您想要一个不依赖任何商业组件的自包含"AI 编辑 WordPress"方案,这不是您要找的。该插件由一人全职开发和维护,许可证费用正是支撑这一点的来源。
安全报告请参阅 SECURITY.md。
Related MCP server: bricks-mcp
Respira 的与众不同之处
大多数 WordPress MCP 服务器只是包装 REST API。它们可以创建文章和页面,但无法触及页面构建器的内容——而那里才是站点的真正所在。
Respira 附带一个 WordPress 插件,让 AI 代理能够原生访问构建器自身的数据结构,并提供让写入线上站点变得安全可控的防护机制。
能力 | Respira | REST API 包装器 |
页面构建器支持 | 17 个构建器 | 无 |
元素级查找 / 更新 / 移动 / 删除 | 支持 | 不支持 |
从声明式结构构建完整页面 | 支持 | 不支持 |
将 HTML 或 Figma 转换为原生构建器输出 | 支持 | 不支持 |
设计方向(全站艺术指导) | 支持 | 不支持 |
跨代理会话持久化的站点记忆 | 支持 | 不支持 |
无障碍扫描与自动修复 | 支持 | 不支持 |
安全审计与核心加固 | 支持 | 不支持 |
每次写入前快照,随时回滚 | 支持 | 不支持 |
编辑前复制安全机制 | 支持 | 不支持 |
从 wp-admin 进行按工具治理 | 支持 | 不支持 |
WordPress Abilities API 与 WebMCP | 支持 | 罕见 |
WooCommerce(产品、订单、库存、店铺前端) | 支持(附加组件) | 不支持 |
快速开始
1. 安装 WordPress 插件
从 respira.press/plugin 下载,上传到 WordPress,激活,然后前往 Respira > API Keys 生成密钥。
2. 连接您的 AI 工具
最快的路径是使用 respira.press/dashboard/mcp 生成的命令,它会自动填入您的站点和密钥。手动配置如下。
claude mcp add respira-wordpress -- npx -y @respira/wordpress-mcp-server添加到 ~/Library/Application Support/Claude/claude_desktop_config.json(macOS)或 %APPDATA%\Claude\claude_desktop_config.json(Windows):
{
"mcpServers": {
"respira-wordpress": {
"command": "npx",
"args": ["-y", "@respira/wordpress-mcp-server"]
}
}
}在您的项目中创建 .cursor/mcp.json:
{
"mcpServers": {
"respira-wordpress": {
"command": "npx",
"args": ["-y", "@respira/wordpress-mcp-server"]
}
}
}格式与上述相同。Codex 在 ~/.codex/config.toml 中使用 TOML:
[mcp_servers.respira-wordpress]
command = "npx"
args = ["-y", "@respira/wordpress-mcp-server"]或者让 add-mcp 自动检测您的工具:
npx add-mcp "npx -y @respira/wordpress-mcp-server"Respira 也以托管远程 MCP 服务器形式运行,支持 OAuth,因此无需本地 Node 进程。各客户端的配置说明请访问 respira.press/mcp。
3. 添加您的站点
运行向导:
npx @respira/wordpress-mcp-server --setup或者自行编写 ~/.respira/config.json:
{
"sites": [
{
"id": "my-site",
"name": "My WordPress Site",
"url": "https://yoursite.com",
"apiKey": "respira_your-api-key",
"default": true
}
]
}重启您的 AI 工具,开始编辑。
遇到客户端工具数量限制?
某些 MCP 客户端会限制活动工具的数量,通常为 100 个。Respira 公布的工具远超此数,因此请在配置中添加 enabledTools,只有这些工具会出现在列表中:
{
"sites": [{ "...": "..." }],
"preferences": {
"enabledTools": [
"respira_read_page",
"respira_update_page",
"respira_list_pages",
"respira_find_element",
"respira_update_element",
"respira_build_page",
"respira_get_site_context",
"respira_get_builder_info"
]
}
}站点管理工具(respira_list_sites、respira_switch_site、respira_get_active_site)始终包含在内。未列出的工具如果直接调用仍然可用。该过滤器只控制公布的内容。
此外,服务器会根据您站点实际运行的内容过滤工具列表。没有 WooCommerce 的 Divi 站点不会看到商务工具。检测采用开放失败策略:如果无法判断,则返回完整列表。
17 个受支持的页面构建器
level 是 Respira 的写入深度,而非构建器的质量。
构建器 | 级别 | 说明 |
Bricks | 深度 | 全局类、主题样式、ACSS、组件、查询循环、BEM 检查 |
Elementor | 完整 | 原生 API、运行时控件注册表 |
Divi | 完整 | Divi 4 和 Divi 5,Divi 5 上 40+ 个模块定义 |
Oxygen | 完整 | 经典版和 Oxygen 6 |
Gutenberg | 完整 | 块注册表、FSE 模板、模式、导航 |
Flatsome | 完整 | 往返短代码编辑、55 元素智能 |
Beaver Builder | 智能 | 树工具、静态模式 |
Breakdance | 智能 | 树工具、静态模式 |
Brizy | 智能 | 树工具 |
WPBakery | 智能 | 树工具 |
Spectra | 智能 | 块目标 |
Kadence Blocks | 智能 | 块目标 |
GenerateBlocks | 智能 | 块目标 |
GreenShift | 智能 | 块目标 |
Visual Composer | 智能 | 有限写入 |
Thrive Architect | 智能 | 文本编辑 |
SeedProd | 智能 | 仅审计 |
混合构建器站点按页面处理,而非按站点处理。
工具覆盖范围
完整参考文档位于文档。工具族包括:
家族 | 功能 |
页面、文章、自定义文章类型 | 使用支持构建器的负载进行读写,支持大纲、复制、翻译 |
元素操作 | 按 ID、类型、类名或内容文本查找、更新、移动、复制、排序、删除单个元素 |
页面构建 | 通过声明式结构调用 |
转换 | HTML 转原生构建器,支持 CSS 提取、响应式映射和保真度评分。通过内置技能将 Figma 转换为 Bricks、Divi、Elementor 或 Gutenberg |
设计方向 | 保存、应用、激活、导出全站艺术方向。提交前预览,将同一方向应用到另一个站点 |
设计令牌 | 创建、更新、导入 DTCG 令牌,将设计系统同步到主题 |
站点记忆 |
|
剧本 | 命名、可复用的流程,代理可以创建、获取和运行 |
快照 | 每次写入前自动创建,比较两个快照,恢复其中任意一个 |
分析 | SEO、AEO、可读性、RankMath、结构化数据、图片、Core Web Vitals、PageSpeed |
无障碍 | 扫描页面、列出扫描结果、应用修复 |
安全 | 安全审计、验证、核心加固、调试日志读取 |
主题和模板 | FSE 模板、模板部件、模式、导航、主题构建器模板、主题文件读写 |
站点结构 | 自定义文章类型、分类法、ACF 字段组、菜单、超级菜单、术语 |
媒体 | 上传、从 URL 侧载、批量元数据更新、Openverse 图库图片搜索并自动标注来源 |
批量操作 | 每次调用最多 100 个页面,强制创建快照 |
多站点 | 从一个配置列出、切换并操作多个站点 |
WooCommerce | 付费插件中的 105 个工具:目录、定价、库存、订单、店面设计 |
所有工具均使用 respira_* 命名。旧版 wordpress_* 别名已弃用,将被移除。
数字的含义
本页面的计数描述的是完全启用站点上的目录,而不是您的客户端将列出的内容。
数字 | 数量 |
MCP 工具,整个产品 | 319 |
每个方案都包含的 MCP 工具 | 214 |
WooCommerce 工具(付费插件) | 105 |
WordPress Abilities | 277 |
独特工具和 Abilities,整个产品 | 320 |
实时的 tools/list 返回的数量少于 319,这是正确行为而非功能缺失。服务器会按站点对目录进行上下文过滤,因此 Bricks 工具永远不会出现在 Elementor 站点上,而没有 WooCommerce 时商务工具也会保持隐藏。没有页面构建器的块主题站点会少看到约 28 个核心工具。
Abilities 注册表不进行上下文过滤,因此在同一站点上,Abilities 总数合理地超过工具总数。两者不可直接比较。
内置技能
该包附带 Respira 的 Claude Code 技能,这些技能是让工具协同工作的配方:页面构建器迁移(Divi 到 Bricks、Elementor 到 Gutenberg、WPBakery 到 Bricks 等)、Figma 到构建器转换、站点审计、SEO 和 AEO 处理,以及 WooCommerce 工作流。
npx @respira/wordpress-mcp-server install-skills在 respira.press/skills 浏览目录。
安全
对生产站点进行写入正是问题的核心。安全护栏:
每次变更前创建快照。 使用
respira_restore_snapshot恢复,使用respira_diff_snapshots比较。编辑前先复制。 代理在副本上工作时,原文件保持不动。
按工具治理。 管理员可以从 wp-admin 启用或禁用单个工具。治理同样适用于 REST 路径、Abilities API 路径和 WebMCP。
只读模式。 让代理指向一个站点,只允许查看而不允许写入。
活动日志。 每次调用都会被记录,可从 wp-admin 和
respira_list_activity读取。
WordPress AI 生态
Respira 与官方 WordPress AI 技术栈协同工作,而非绕开它。
路径 | 工作原理 | 要求 |
独立 MCP(本包) |
| Node 18+、Respira 插件 |
远程 MCP | 带 OAuth 的托管端点,无需本地进程 | Respira 插件、账户 |
WordPress Abilities API | 注册 277 个 Abilities,自动发现 | WP 6.9+、Respira 插件 |
MCP 适配器 | 通过 WP-CLI STDIO 暴露 Abilities | WP 6.9+、MCP Adapter 插件 |
WebMCP | 通过 Chrome Abilities API 实现浏览器原生 MCP | Chrome 146+、Respira 插件 |
Inhale 是免费的配套插件,无需 Respira 账户即可注册一小部分 Abilities,如果您想先尝试 Abilities 路径,可以试试它。
安装选项
npx
npx -y @respira/wordpress-mcp-server零安装,适合试用。缺点是 npx 缓存在安装中断、外置硬盘断开或杀毒软件隔离后可能会损坏,由此产生的 ENOENT 错误令人困惑。请参阅故障排除。
全局安装(最稳定)
npm install -g @respira/wordpress-mcp-server
respira-wordpress-mcp完全避开 npx 缓存。日常使用的更好选择。
CLI 选项
标志 | 别名 | 描述 |
|
| 交互式设置向导 |
|
| 列出已配置的站点 |
|
| 测试连接 |
|
| 健康诊断,添加 |
| 为检测到的客户端写入 MCP 配置 | |
| 将内置技能复制到本地技能目录 | |
| 用于 MCP 适配器的 STDIO 传输 | |
|
| 打印版本 |
|
| 帮助 |
环境变量
export WORDPRESS_URL="https://yoursite.com"
export WORDPRESS_API_KEY="respira_your_key"RESPIRA_CONFIG_FILE 和 RESPIRA_CONFIG_B64 是多站点替代方案。
健康检查
npx @respira/wordpress-mcp-server --doctor检查 Node 版本、配置文件、站点连接、插件版本、API 兼容性和可用更新,并针对每项检查报告通过或失败,同时给出可操作的建议。添加 --json 可用于 CI 流水线。
故障排除
使用完整路径:
{ "command": "C:\\Program Files\\nodejs\\npx.cmd", "args": ["-y", "@respira/wordpress-mcp-server"] }或使用 npm install -g @respira/wordpress-mcp-server 进行全局安装,然后使用 { "command": "respira-wordpress-mcp" }。
在 WordPress > Respira > API Keys 中检查 API 密钥
URL 必须包含
https://插件必须已激活
检查您的主机是否阻止了 REST API
respira_diagnose_connection 一次调用即可报告全部四项。
某些站点的插件或主题重写规则会捕获 /wp-json/[anything] 并将路径重写为 index.php,但不带 ?rest_route= 查询变量。WordPress 随后会 301 重定向到首页(您会在重定向链中看到 x-redirect-by: WordPress),MCP 服务器收到的就是 HTML 而不是预期的 JSON。
服务器会自动检测到这种情况,以 ?rest_route=... 的形式针对站点根目录重试该调用,如果返回 JSON,则会在本次会话的剩余时间内以相同方式路由所有后续调用,并在首次激活时输出一条 stderr 警告。
如果您已经知道重写遮蔽在起作用,可以使用 forceRestRoute 跳过探测:
{
"sites": [
{
"id": "my-site",
"url": "https://yoursite.com",
"apiKey": "respira_your-api-key",
"default": true,
"forceRestRoute": true
}
]
}respira_diagnose_connection 会探测两种形式,并报告 rest_route_fallback_worked、rest_route_fallback_active 和 force_rest_route_configured。
完全重启 AI 工具,而不仅仅是窗口
验证配置文件中的 JSON 语法
确认您的客户端对应的配置文件位置
运行
npx @respira/wordpress-mcp-server --test
如果客户端限制了活动工具的数量,请参阅上面的 enabledTools。
npx 缓存已损坏。常见原因:安装中断、安装过程中外置硬盘断开、杀毒软件隔离,或 npx 处于活动状态时运行了 npm cache clean。
# 1. Switch to a global install, most stable
npm install -g @respira/wordpress-mcp-server
# then use "command": "respira-wordpress-mcp" with no npx wrapper
# 2. Or clear the npx cache and let it rebuild
npx clear-npx-cache
npx -y @respira/wordpress-mcp-server
# 3. Or clear the whole npm cache
npm cache clean --force安全
API 密钥验证在 WordPress 插件端进行。MCP 服务器仅传递凭据,不存储或验证它们。
请将漏洞报告发送至 security@respira.press。完整政策见 SECURITY.md。
链接
在哪里找到 Respira
目录 | 列表 |
npm | |
官方 MCP 注册表 |
|
Smithery | |
Glama | |
mcp.so | |
cursor.directory |
许可证
MIT © Respira
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
WordPress MCP server: publish posts, AI images, SEO and full site management, self-hosted
Security-first WordPress MCP server. 129 tools for Claude, ChatGPT, Gemini. Free on wp.org.
WordPress MCP server: generate SEO posts, AI images, autoblog & WooCommerce on your self-hosted site
Run all of WordPress from Claude, ChatGPT or Cursor: SEO, security, your WooCommerce shop and Elementor pages, on up to 10 websites in one connector. Start free. SEO: titles, descriptions and focus keywords for every page, post and product. Security & updates: core, plugin and theme updates with a live test, site health and HTTPS checks, users and roles. WooCommerce shop: products, prices, orders, coupons and customers. Elementor and many more page builders: texts, links and images. Blog posts, pages, media, comments and menus. 10 websites in one connector: all your sites in the same chat. Deploy (Agency): build a site locally and push it to your own server. Just say it: "Write SEO titles for every product." "Install all updates and check that the site still works." "Show today's orders and create a weekend coupon." You choose what your AI may change, with one switch. Install the free AlphaBridge MCP plugin from WordPress.org, connect and approve on your own site. No account, no key to copy.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server for WordPress automation that enables users to manage content, themes, and site configurations using AI-driven workflows and the WordPress REST API. It provides a wide array of tools for site planning, management, and optimization compatible with tools like Cursor and Claude.1MIT
- AlicenseBqualityBmaintenanceComprehensive MCP server for Bricks Builder with 100+ tools to manage pages, templates, styles, SEO, and content directly from AI assistants like Claude Code.11595MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that enables AI agents to manage WordPress sites, including Elementor page building, content CRUD, plugin management, and site configuration via the WordPress REST API.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for WordPress content management that provides a secure interface for AI assistants to interact with WordPress sites, enabling content creation, editing, and media management without destructive operations.MIT