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: elementor-mcp-agent

Respira 的与众不同之处

大多数 WordPress MCP 服务器只是包装 REST API。它们可以创建文章和页面，但无法触及页面构建器的内容——而那里才是站点的真正所在。

Respira 附带一个 WordPress 插件，让 AI 代理能够原生访问构建器自身的数据结构，并提供让写入线上站点变得安全可控的防护机制。

快速开始

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 的写入深度，而非构建器的质量。

混合构建器站点按页面处理，而非按站点处理。

工具覆盖范围

完整参考文档位于文档。工具族包括：

所有工具均使用 respira_* 命名。旧版 wordpress_* 别名已弃用，将被移除。

数字的含义

本页面的计数描述的是完全启用站点上的目录，而不是您的客户端将列出的内容。

实时的 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 浏览目录。

安全

对生产站点进行写入正是问题的核心。安全护栏：

1. 每次变更前创建快照。 使用 respira_restore_snapshot 恢复，使用 respira_diff_snapshots 比较。

2. 编辑前先复制。 代理在副本上工作时，原文件保持不动。

3. 按工具治理。 管理员可以从 wp-admin 启用或禁用单个工具。治理同样适用于 REST 路径、Abilities API 路径和 WebMCP。

4. 只读模式。 让代理指向一个站点，只允许查看而不允许写入。

5. 活动日志。 每次调用都会被记录，可从 wp-admin 和 respira_list_activity 读取。

WordPress AI 生态

Respira 与官方 WordPress AI 技术栈协同工作，而非绕开它。

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 选项

环境变量

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" }。

1. 在 WordPress > Respira > API Keys 中检查 API 密钥

2. URL 必须包含 https://

3. 插件必须已激活

4. 检查您的主机是否阻止了 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。

1. 完全重启 AI 工具，而不仅仅是窗口

2. 验证配置文件中的 JSON 语法

3. 确认您的客户端对应的配置文件位置

4. 运行 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。

链接

• 网站

• 文档

• 下载插件

• MCP 设置

• 技能目录

• Abilities

• WooCommerce 插件

• 无障碍扫描器插件

• 支持

在哪里找到 Respira

许可证

MIT © Respira