Wp MCP Audit

WP MCP审计

通过MCP（模型上下文协议）进行远程WordPress/WooCommerce诊断和修复。不需要SSH。

AI Client (Claude Desktop / Cursor)
    |  MCP Protocol (stdio)
    |
MCP Server (Node.js)
    |  HTTPS REST API (Basic Auth)
    |
WordPress Plugin
    |  Runs checks, reads files, queries DB, applies fixes
    |
Client's WordPress Site

安装 WordPress插件 在客户网站上。通过连接 MCP服务器 来自任何AI客户端。运行诊断程序、阅读插件/主题源代码、查询数据库和应用修复程序——所有这些都是对话式的。

快速开始

1.安装WordPress插件

上传 wp-mcp-audit/ 给你的客户 wp-content/plugins/ 目录并激活它。

要求： PHP 7.4+，WordPress 5.8+

该插件创建了一个“审计员”角色，并在激活时注册自定义功能。管理员自动获得所有功能。

2.创建应用程序密码

在客户端的WordPress管理中，转到 用户>个人资料>应用程序密码.创建API访问的密码。

3.配置MCP服务器

创建 ~/.wp-audit/sites.json:

{
  "sites": [
    {
      "id": "client-acme",
      "label": "ACME Corp Website",
      "url": "https://acme.example.com",
      "username": "audit-user",
      "application_password": "xxxx xxxx xxxx xxxx",
      "features": ["woocommerce"]
    }
  ]
}

4.添加到克劳德桌面

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "wp-audit": {
      "command": "npx",
      "args": ["-y", "mcp-server-wp-audit"],
      "env": {
        "WP_AUDIT_SITES_CONFIG": "~/.wp-audit/sites.json"
      }
    }
  }
}

或者从本地构建运行：

{
  "mcpServers": {
    "wp-audit": {
      "command": "node",
      "args": ["/path/to/mcp-server-wp-audit/dist/bin/wp-audit-mcp.js"],
      "env": {
        "WP_AUDIT_SITES_CONFIG": "~/.wp-audit/sites.json"
      }
    }
  }
}

5.开始审核

在Claude Desktop中，尝试：

“在客户端acme上运行完整诊断”

“客户acme有哪些关键问题？”

“清理客户端acme上过期的瞬态”

“阅读woocommerce的主插件文件并检查是否有任何问题”

“显示与缓存相关的wp_options行”

“修补我的孩子主题中的functions.php以修复损坏的过滤器”

______________________________________________________________________

项目结构

wordpress-mcp-audit/
├── wp-mcp-audit/                 # WordPress Plugin (PHP)
│   ├── wp-mcp-audit.php          # Plugin bootstrap
│   ├── uninstall.php             # Cleanup on uninstall
│   ├── includes/
│   │   ├── class-autoloader.php  # PSR-4 autoloader (no Composer needed)
│   │   └── class-plugin.php      # Plugin singleton
│   └── src/
│       ├── Api/                  # REST controllers (6 files)
│       ├── Checks/               # 48 diagnostic checks (9 categories)
│       ├── Fixes/                # 12 fix classes
│       ├── Security/             # API keys, rate limiter, audit log
│       ├── Admin/                # WP admin settings pages
│       ├── Abilities/            # Roles & capabilities
│       └── Registry/             # Check & fix registries
│
└── mcp-server-wp-audit/          # MCP Server (Node.js/TypeScript)
    ├── bin/wp-audit-mcp.ts       # CLI entry point
    └── src/
        ├── index.ts              # Server init, tool registration
        ├── config/               # Multi-site config, types
        ├── client/               # REST API client
        ├── tools/                # 30 MCP tools
        ├── resources/            # Known conflicts, recommended settings
        └── prompts/              # Guided audit workflow

______________________________________________________________________

REST API端点

命名空间： wp-mcp-audit/v1

诊断和站点信息

修复

\*需要风险修复 wp_mcp_audit_fix_risky.

文件访问

数据库

所有权限都以前缀 wp_mcp_audit_ （例如。， read = wp_mcp_audit_read).

______________________________________________________________________

MCP工具

MCP服务器中有30个可用工具：

诊断

修复

站点信息

文件访问

数据库

多站点

WooCommerce

报告

______________________________________________________________________

诊断检查（48）

每次检查都会返回一个标准化的结果：

{
  "id": "wp-version",
  "category": "core",
  "label": "WordPress Version",
  "status": "warning",
  "severity": 7,
  "description": "WordPress 6.4 is installed but 6.7 is available.",
  "details": { "current": "6.4.3", "latest": "6.7.1" },
  "fix": { "id": "manual-update", "type": "manual" },
  "timestamp": "2026-02-08T12:00:00+00:00"
}

状态值： good, warning, critical, info 严重程度：1（低）至10（严重）

______________________________________________________________________

修复（12）

自动修复（安全、可逆）

手册（仅说明）

有风险（需要确认）

所有自动修复程序都会在中创建备份 wp_options （前缀 _wp_mcp_audit_backup_，24小时到期）并支持回滚。

______________________________________________________________________

安全

认证

• WordPress应用程序密码 （HTTPS基本身份验证）-主要身份验证方法
• 自定义API密钥 通过 X-WP-Audit-Key header-可选，在WP-admin中管理

API键的前缀为 wmca_，通过哈希存储 wp_hash_password()，并支持细粒度权限(read, fix_safe, fix_risky, manage).

授权

具有专门“审计员”角色的定制功能：

管理员在插件激活时获得所有四种功能。

速率限制

基于传输，根据API密钥或IP地址：

• 阅读： 60个请求/分钟（可配置）
• 写道： 10个请求/分钟（可配置）
• 退货 429 Too Many Requests 随着 Retry-After 超过标题时

审计日志

所有API访问都记录到自定义数据库表中({prefix}mcp_audit_log)与：

• 时间戳、用户ID、API密钥标签
• 端点、HTTP方法、IP地址
• 请求参数、响应状态

30天后通过WP Cron自动清理日志（可在设置中配置）。

______________________________________________________________________

WP管理页面

激活后，在下面找到这些 工具 在WordPress管理中：

• WP MCP审计 -启用/禁用API，配置速率限制，设置日志保留期
• API密钥 -使用per-key权限生成、查看和吊销API密钥

______________________________________________________________________

发展

MCP服务器

cd mcp-server-wp-audit
npm install
npm run build    # Compile TypeScript
npm run dev      # Watch mode
npm start        # Run the server

需要Node.js 18+。

WordPress插件

无需构建步骤。该插件包含自己的PSR-4自动加载器，在客户端站点上无需Composer即可工作。

对于使用Composer自动加载的开发：

cd wp-mcp-audit
composer install

______________________________________________________________________

多站点管理

MCP服务器支持从单个配置管理多个WordPress站点。网站存储在 ~/.wp-audit/sites.json 默认情况下（可通过配置 WP_AUDIT_SITES_CONFIG 有人）。

{
  "sites": [
    {
      "id": "client-acme",
      "label": "ACME Corp Website",
      "url": "https://acme.example.com",
      "username": "audit-user",
      "application_password": "xxxx xxxx xxxx xxxx",
      "api_key": "wmca_optional_api_key",
      "features": ["woocommerce"]
    },
    {
      "id": "client-beta",
      "label": "Beta Store",
      "url": "https://beta.example.com",
      "username": "audit-user",
      "application_password": "yyyy yyyy yyyy yyyy",
      "features": ["woocommerce"]
    }
  ]
}

使用 batch_diagnostics 一次在所有站点上运行检查，或 compare_diagnostics 并排比较两个站点。

______________________________________________________________________

卸载

当通过WordPress管理员删除插件时， uninstall.php 将：

• 放下 {prefix}mcp_audit_log 桌子
• 删除全部 _wp_mcp_audit_* 选项（备份、设置、API密钥）
• 从所有角色中删除审核员角色和所有自定义功能

______________________________________________________________________

许可证

• WordPress插件：GPL-2.0或更高版本
• MCP服务器：MIT

______________________________________________________________________

由...建造 OBS技术