WordPress.org 提供了一个 MCP（模型上下文协议）服务器，让 AI 驱动的开发工具帮助您准备、验证并向插件目录提交插件。如果您使用 Claude、Cursor 或具备 AI 功能的 VS Code 等工具，可以将它们连接到 WordPress.org，使它们能够直接访问插件指南、readme 验证、提交状态等信息。

这是一个辅助您工作流程的工具，而非审查流程的替代品。所有通过 MCP 服务器提交的插件都会与通过网页表单提交的插件接受相同的审查。所有 插件指南均完全适用。

什么是 MCP？

模型上下文协议（MCP）是一项开放标准，允许 AI 助手连接到外部服务。与其在您的 AI 工具和 WordPress.org 之间复制粘贴内容，MCP 连接允许您的 AI 助手读取插件指南、验证 readme、检查提交状态并提交插件，所有操作均在您现有的开发环境中完成。

先决条件

设置您的连接

快速设置

在终端中运行此命令：

npx -y @wporg/mcp

这将打开您的浏览器以授权连接并创建应用程序密码，然后自动检测并配置您已安装的 MCP 客户端（目前支持 Claude Desktop、Claude Code、Cursor 和 VS Code）。

如果您的客户端尚未得到支持，请 告知我们 并使用下方的手动设置。

手动设置

如果您希望自行配置连接，或者您的客户端尚未被快速设置支持，请按照以下步骤操作。

步骤 1：授权连接

访问授权页面以开始：

授权 WordPress.org MCP →

如果您尚未登录，将首先提示您登录您的 WordPress.org 账户。登录后，您将看到“WordPress.org MCP”的授权屏幕。点击 批准 以生成您的连接凭据。

每个账户同一时间只存在一个 MCP 应用程序密码。如果稍后再次授权，之前的密码将被撤销并创建一个新的。

步骤 2：复制您的配置

批准之后，您将看到一个 JSON 配置块，如下所示：

{
  "mcpServers": {
    "wporg-mcp-server": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@^0.2"],
      "env": {
        "WP_API_URL": "https://wordpress.org/wp-json/mcp/wporg",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "xxxx xxxx xxxx xxxx"
      }
    }
  }
}

点击 复制 将此配置复制到剪贴板。您的应用程序密码仅显示一次。如果丢失，您需要再次授权以生成新的密码。

步骤 3：添加到您的 MCP 客户端

粘贴配置的位置取决于您使用的客户端：

  • Claude Desktop：打开设置，然后选择开发者，接着编辑配置。将配置粘贴到您的 claude_desktop_config.json 文件中。
  • Claude Code：将配置添加到项目目录中的 .mcp.json 文件。
  • Cursor：进入设置，然后选择工具和 MCP，接着添加自定义 MCP。
  • VS Code：保存为 .vscode/mcp.json。使用 servers 作为顶层键，而不是 mcpServers。

保存后，重启您的客户端或重新加载 MCP 配置。您的 AI 助手现在应该可以访问 WordPress.org 插件目录工具。

可用内容

MCP 服务器提供三种类型的功能：您的 AI 助手可执行的工具、它可以读取的参考资源以及常见工作流程的引导提示。

工具

工具是您的 AI 助手可以为您执行的操作：

  • 验证 readme：在提交前检查您的 readme.txt 或 readme.md 中的错误、警告和建议。
  • 获取插件状态：检索您已提交的插件的当前审查状态和任何审查员反馈。
  • 提交插件：提交新插件进行审查，或更新仍在审查中的现有提交。
提交插件工具用于新提交和更新正在审查中的插件。一旦插件获得批准，更新将通过 Subversion 发布。

资源

资源是您的 AI 助手可以读取的参考文档，以提供准确、最新的指导：

提示

提示是引导您和您的 AI 助手完成多步流程的工作流程：

  • 为提交准备插件：涵盖指南审查、头部验证、readme 验证、插件检查和提交就绪性的逐步检查清单。
  • 运行插件检查：安装和运行插件检查的说明，使用与 WordPress.org 自动化审查相同的标志。
  • 处理审查反馈：获取审查员反馈、理解所需更改、应用修复并重新提交的引导工作流程。

您的责任

使用 MCP 服务器不会改变您作为插件开发者的责任。无论您是亲手编写每一行代码还是使用 AI 辅助，以下规定均适用：

您对插件中的所有代码负责。插件审查团队以相同方式评估每一次提交，无论代码是如何生成的。如果您的插件被拒绝，您需要理解问题并进行必要的更改。

详细插件指南 对 AI 辅助提交的插件不会放宽要求。您的插件必须是原创的、安全的、性能良好的，并按照 与 GPL 兼容的许可证 分发。必须尊重商标和版权法。

审查 AI 生成的内容

AI 工具可能会引入安全漏洞、许可证违规、不必要的外部服务调用或不匹配您意图的代码。在提交插件之前，您必须审查您的 AI 助手所做的每一次更改。在本地运行 插件检查 是发现常见问题的好方法，也是提交插件进行审查的先决条件。

示例工作流程

以下是开发人员使用 MCP 服务器的一些常见方式。在每种情况下，您都在开发工具中与您的 AI 助手交谈。助手为您处理与 MCP 服务器的通信。

为提交准备插件

请求您的 AI 助手帮助您准备插件：

Help me prepare my plugin for submission to WordPress.org.

您的助手将逐步执行多步骤检查清单：审查您的插件是否符合指南要求、验证插件头部信息、确认 readme 文件、运行 Plugin Check、检查保留的 slug，并生成提交就绪报告。

检查审核状态

提交后，您可以查看插件的状态：

我的插件 "my-awesome-plugin" 的审核状态是什么？

您的助手将获取当前状态，包括审核团队的任何反馈。

处理审核员反馈

如果您的插件需要修改，您的助手可以帮助您处理反馈：

帮我处理 "my-awesome-plugin" 的审核反馈。

您的助手将获取审核员的评论，帮助您理解要求的内容，提出修复建议，并协助您重新验证和重新提交。

故障排除

身份验证错误

如果您看到身份验证错误，您的应用程序密码可能已过期或被撤销。请访问 授权页面 再次生成新的密码。重新通过授权流程将自动替换您现有的应用程序密码。使用新凭据更新您的客户端配置。

撤销访问权限

若要撤销您的 MCP 连接，请访问 profiles.wordpress.org 上的 账户与安全 设置，并打开应用程序密码部分。在那里您可以找到并删除为 MCP 连接创建的应用程序密码。