SRZ MCP 服务器 WP

一个全面的WordPress插件，用于创建一个MCP（模型上下文协议）服务器以实现AI集成。此插件提供 194+种工具 通过Cursor、Claude Desktop或VS Code等AI客户端实现完整的WordPress和WooCommerce管理。

🚀 表情符号“🚀”在中文中通常被翻译为“火箭”或“🚀（火箭表情）”。不过，由于表情符号的翻译往往依赖于上下文和文化背景，有时也可能直接保留原样或根据具体情境进行意译。在这个例子中，由于没有具体的上下文，所以直接翻译为“火箭”或保留原样“🚀（火箭表情）”都是可以的。 194+ 个可用工具

核心WordPress管理（31种工具）

网站信息、状态监控和配置
用户管理、角色和权限
内容管理（帖子、页面、媒体）
数据库操作与优化
系统维护和调试
定时任务管理
WordPress核心更新与配置

站点管理（10种工具）

网站状态监控和健康检查
URL管理与重定向
维护模式控制
缓存管理与优化
安全加固与监控

插件与主题工具（20款工具）

插件的安装、激活和管理
主题切换与自定义
插件和主题的批量操作
更新管理与版本控制
依赖检查与冲突解决

安全管理（20种工具）

安全扫描和漏洞评估
恶意软件检测与移除
IP封锁和防火墙管理
用户安全与访问控制
安全审计和合规检查

性能与缓存（32种工具）

缓存管理（对象、页面、数据库）
性能监控与优化
CDN配置与管理
数据库优化与清理
资源监控和警报

数据库与文件工具（25种工具）

数据库查询与管理
备份和恢复操作
文件系统操作与安全
搜索和替换功能
数据迁移和同步

电子邮件与通知（36款工具）

电子邮件发送和模板管理
通知系统配置
队列管理与监控
分析与报告
Webhook管理与测试

WooCommerce高级管理（20+工具）

产品管理完成完整的CRUD操作
批量操作批量产品更新与管理
订单处理订单管理及状态更新
客户管理客户数据和订单历史
库存控制库存管理和监控
分析与报告销售数据和绩效指标
优惠券管理折扣的创建与管理
设置配置WooCommerce设置管理

WooCommerce 产品编辑器（10+种工具）

产品编辑名称、描述、价格、SKU更新
品类管理添加/删除产品类别
标签管理产品标签操作
属性管理产品属性和变体
搜索引擎优化元描述和关键词
形象管理特色图片和图库
库存管理库存追踪与提醒
定价管理定期更新常规价格和促销价格

✨（星星眼表情，通常表示惊喜、赞叹或开心的情绪）关键特性

全面的WordPress控制权

194+种工具 涵盖WordPress管理的各个方面
实时监控 网站健康状况和性能
自动化维护 任务与优化
安全加固 以及漏洞扫描
数据库管理 以及优化

高级WooCommerce集成

产品管理具备批量处理能力的完整CRUD操作
订单处理完整的订单生命周期管理
客户洞察客户数据分析与行为分析
库存控制库存管理与自动提醒
分析仪表板销售报告和业绩指标
营销工具优惠券管理和促销活动

AI赋能功能

智能产品描述利用AI生成内容以优化SEO
智能分类自动产品分类
内容优化生成对SEO友好的内容
自动化工作流智能自动化处理重复性任务

开发者友好

REST API 集成完全符合WordPress REST API规范
可扩展架构易于添加自定义工具
全面日志记录详细的运行日志和调试信息
错误处理优雅的错误管理和报告

🏗️ 建筑学

该插件采用模块化、可扩展的架构设计：

核心模块处理MCP协议、REST API和核心功能
能力管理器管理能力注册与执行
钩子管理器为其他插件提供扩展性系统
管理界面带有现代用户界面的WordPress管理仪表盘
WooCommerce 集成全面的电子商务能力
WooCommerce高级管理高级批量操作与自动化
扩展系统允许其他插件添加自定义功能

🚀 表情符号“🚀”在中文中通常被翻译为“火箭”或直接保留为“🚀”（因其本身具有直观的火箭形象）。所以，这个表情可以简单地理解为“火箭”或直接用“🚀”来表示。快速入门

先决条件

WordPress 5.0+ 已启用 REST API
WooCommerce（可选，用于电子商务功能）
Node.js（用于MCP服务器集成）
Cursor 集成开发环境（IDE）或 Claude 桌面版

安装

步骤1：安装插件

将插件文件上传至 /wp-content/plugins/srz-mcp-server-wp/
通过WordPress管理后台激活插件
配置固定链接（设置 > 固定链接）- 选择“Plain”以外的任何结构

步骤2：启用开发模式

添加到您的 wp-config.php：

define('WP_ENVIRONMENT_TYPE', 'local');
define('WP_DEBUG', true);

步骤3：安装Node.js依赖项

cd wp-content/plugins/srz-mcp-server-wp
npm install

步骤4：设置应用程序密码

在WordPress管理后台中，进入“用户”>“个人资料”
向下滚动到“应用程序密码”部分
创建一个新的应用程序密码（请安全保存）
记下你的用户名（通常是“admin”）

🔧 修理工具或扳手的象征配置

Cursor 集成开发环境 (IDE) 配置

创建或更新您的 ~/.cursor/mcp.json 文件：

{
  "mcpServers": {
    "srz-mcp-server": {
      "command": "npm",
      "args": ["start"],
      "cwd": "/path/to/your/wp-content/plugins/srz-mcp-server-wp"
    }
  }
}

重要的替换 /path/to/your/wp-content/plugins/srz-mcp-server-wp 使用你实际的插件路径。

Claude桌面配置

编辑你的 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "srz-mcp-server": {
      "command": "npm",
      "args": ["start"],
      "cwd": "/path/to/your/wp-content/plugins/srz-mcp-server-wp"
    }
  }
}

VS Code 配置

创建一个 .vscode/mcp.json 在你的WordPress根目录中创建文件：

{
  "servers": {
    "srz-mcp-server": {
      "command": "npm",
      "args": ["start"],
      "cwd": "/path/to/your/wp-content/plugins/srz-mcp-server-wp"
    }
  }
}

测试连接

配置完成后，请重启您的AI客户端，并进行以下测试：

# Test the MCP server directly
curl -X POST http://wp.test/wp-json/srz-mcp-server/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": "test"}'

你应该会看到一个响应，显示有194+个可用工具。

可用能力

网站信息

能力： srz-mcp-server/get-site-info
描述获取WordPress网站的基本信息
权限: read
输出网站标题、描述、网址、管理员邮箱、时区、语言

帖子管理

列出帖子： srz-mcp-server/list-posts

- 参数： post_type， posts_per_page， status - 权限： read

创建帖子: srz-mcp-server/create-post

- 参数： title （必填）， content （必填）， post_type， status， excerpt - 权限： edit_posts

获取帖子: srz-mcp-server/get-post

- 参数： post_id （必填） - 权限： read

更新帖子： srz-mcp-server/update-post

- 参数： post_id （必填）， title， content， status， excerpt - 权限： edit_posts

用户管理

列出用户： srz-mcp-server/list-users

- 参数： role， number - 权限： list_users

系统信息

获取插件： srz-mcp-server/get-plugins

- 权限： activate_plugins - 输出：带有激活状态的插件列表

WooCommerce 能力

产品管理

列出产品： woo/get-products

- 参数： status， per_page， search， category， stock_status， featured - 权限： edit_products

获取产品： woo/product/get

- 参数： product_id （必填） - 权限： edit_products

更新产品： woo/product/update

- 参数： product_id （必填）， name， description， regular_price， sale_price， stock_quantity， stock_status - 权限： edit_products

批量操作

批量更新产品： woo/products/bulk-update

- 参数： product_ids （数组）， update_data (对象) - 权限： edit_products - 描述：使用相同数据更新多个产品

批量更新分类： woo/products/bulk-categories

- 参数： product_ids （数组）， categories （数组） - 权限： edit_products - 描述：更新多个产品的分类

批量更新定价: woo/products/bulk-pricing

- 参数： product_ids (数组)， pricing_data （对象） - 权限： edit_products - 描述：更新多个产品的价格

高级管理

增强批量更新: wc_bulk_update_enhanced

- 参数：无（处理所有产品） - 权限： edit_products - 描述：为所有产品更新包含500多个单词的描述，并设置合适的类别 - 特点： - 生成全面的产品描述 - 基于产品名称的智能分类分配 - 更新简短描述以优化SEO - 在整个过程中保持数据完整性

订单管理

列出订单: woo/get-orders

- 参数： status， per_page， customer_id， date_from， date_to - 权限： edit_shop_orders

分类与标签

列出类别: woo/categories/list

- 权限： edit_products - 输出：包含层级结构的所有产品类别

列出标签： woo/tags/list

- 权限： edit_products - 输出：所有产品标签

🎯 目标（靶心）使用示例

使用Cursor IDE

配置完成后重启光标
使用聊天面板与您的WordPress网站进行互动：

现场管理：

“显示我的WordPress网站信息”
“当前网站的状态是什么？”
“列出所有已激活的插件”
“检查网站性能指标”

内容管理：

“创建一篇关于WordPress的新博客文章”
“列出所有已发布的帖子”
“更新ID为123的帖子”
“显示所有媒体文件”

WooCommerce 管理：

“列出所有WooCommerce产品”
“给我看看ID为456的产品”
“更新所有产品的价格”
“为产品789添加类别”
“给我显示上个月的所有订单”

高级操作：

“运行安全扫描”
“优化数据库”
“清除所有缓存”
“检查插件更新”

使用 Claude Desktop

配置完成后重启Claude桌面版
使用“搜索和工具”功能
提出这样的问题：

- “这个网站上注册了哪些用户？” - “撰写一篇关于人工智能融合的草稿帖子” - “显示电子类别的所有产品” - “为所有产品更新更完善的描述” - “进行绩效审计”

产品管理示例

获取产品信息：

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "woo/product/get",
    "arguments": {
      "product_id": 123
    }
  }
}

更新产品：

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "woo/product/update",
    "arguments": {
      "product_id": 123,
      "name": "Updated Product Name",
      "description": "New product description",
      "regular_price": "29.99"
    }
  }
}

为产品添加类别：

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "woo/product/categories/add",
    "arguments": {
      "product_id": 123,
      "categories": ["Electronics", "Gadgets"]
    }
  }
}

使用Postman进行测试

你可以直接使用Postman测试MCP服务器：

列出工具：

   {
       "jsonrpc": "2.0",
       "method": "tools/list",
       "params": {}
   }

调用一个工具：

   {
       "jsonrpc": "2.0",
       "method": "tools/call",
       "params": {
           "name": "srz-mcp-server-get-site-info",
           "arguments": {}
       }
   }

批量更新产品：

   {
       "jsonrpc": "2.0",
       "method": "tools/call",
       "params": {
           "name": "wc_bulk_update_enhanced",
           "arguments": {}
       }
   }

安全

所有功能均尊重WordPress用户的权限和能力
所有MCP请求均需进行身份验证
用户只能执行他们被授权执行的操作
应用程序密码提供安全的API访问
对所有参数进行输入验证和清理
限制速率以防止滥用

🔧 修理工具/螺丝刀故障排除

常见问题

“MCP服务器无法连接”

- 重启您的AI客户端（Cursor/Claude Desktop） - 检查插件路径中的 mcp.json 是正确的 - 确保已安装 Node.js 依赖项（npm install) - 验证MCP服务器是否正在运行： npm start

“未显示工具”

- 检查该插件是否已在WordPress中激活 - 验证固定链接未设置为“简单”格式 - 直接使用curl测试REST API终端点 - 检查WordPress调试日志中的错误

“权限被拒绝错误”

- 确保 WP_ENVIRONMENT_TYPE 设置为“本地”在 wp-config.php - 检查是否已启用应用程序密码 - 验证用户是否具备相应的权限

REST API 端点不存在

- 确保固定链接未设置为“简单”格式 - 检查插件是否已激活 - 验证终端节点： http://wp.test/wp-json/srz-mcp-server/v1/mcp

调试步骤

直接测试MCP服务器：

   curl -X POST http://wp.test/wp-json/srz-mcp-server/v1/mcp \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc": "2.0", "method": "tools/list", "id": "test"}'

检查WordPress调试日志：

- 启用 WP_DEBUG 在 wp-config.php - 检查 /wp-content/debug.log 对于错误

验证插件激活：

- 进入“插件”>“已安装插件” - 确保“SRZ MCP Server WP”处于激活状态

测试 Node.js MCP 服务器：

   cd wp-content/plugins/srz-mcp-server-wp
   npm start

寻求帮助

如果你仍然遇到问题：

检查WordPress调试日志
直接测试REST API终端
验证您的MCP配置
确保所有依赖项都已安装
配置更改后重启您的AI客户端

🔧 创建扩展

该插件提供了一个全面的扩展系统，允许其他插件添加自己的MCP（可能是指某种特定功能或能力，如“模块化插件能力”等，具体需根据上下文确定）能力。请参阅 examples/example-extension.php 请参阅完整的示例文件。

快速入门

class My_Plugin_MCP_Extension {
    
    public function __construct() {
        add_filter('srz_mcp_server_extensions', array($this, 'register_extension'));
        add_action('abilities_api_init', array($this, 'register_abilities'));
    }
    
    public function register_extension($extensions) {
        $extensions['my-plugin'] = array(
            'name' => 'My Plugin Extension',
            'description' => 'Adds MCP abilities for My Plugin',
            'version' => '1.0.0',
            'load_abilities' => array($this, 'load_abilities')
        );
        return $extensions;
    }
    
    public function register_abilities() {
        wp_register_ability(
            'srz-mcp-server/my-plugin/my-ability',
            array(
                'label' => 'My Ability',
                'description' => 'Does something useful',
                'category' => 'my-plugin',
                'permissions' => array('read'),
                'inputs' => array(
                    'param1' => array(
                        'type' => 'string',
                        'description' => 'Parameter description',
                        'required' => true
                    )
                ),
                'outputs' => array(
                    'result' => array(
                        'type' => 'string',
                        'description' => 'Result description'
                    )
                )
            ),
            array($this, 'my_ability_callback')
        );
    }
    
    public function my_ability_callback($args) {
        return array('result' => 'success');
    }
}

new My_Plugin_MCP_Extension();

可用的钩子（或回调点）

该插件提供了丰富的钩子用于自定义：

扩展钩子注册和管理扩展
能力钩子（或功能钩子）修改能力数据、权限和执行权限
管理钩子（或管理插件钩子）添加管理员菜单项和页面
REST API 插件修改请求和响应

如需完整的文档，请参阅 DEVELOPER.md 翻译为中文是：“开发者指南/说明文件（Markdown 格式）”。

发展

添加自定义能力

要添加自己的能力，请使用 wp_register_ability() 功能：

wp_register_ability(
    'srz-mcp-server/custom-ability',
    array(
        'label' => 'Custom Ability',
        'description' => 'Description of what this ability does',
        'category' => 'custom',
        'permissions' => array('read'),
        'inputs' => array(
            'param1' => array(
                'type' => 'string',
                'description' => 'Parameter description',
                'required' => true
            )
        ),
        'outputs' => array(
            'result' => array(
                'type' => 'string',
                'description' => 'Output description'
            )
        )
    ),
    'your_callback_function'
);

WooCommerce 扩展示例

class WooCommerce_MCP_Extension {
    
    public function __construct() {
        add_action('abilities_api_init', array($this, 'register_woocommerce_abilities'));
    }
    
    public function register_woocommerce_abilities() {
        // Register WooCommerce-specific abilities
        wp_register_ability(
            'srz-mcp-server/woocommerce/bulk-update-products',
            array(
                'label' => 'Bulk Update Products',
                'description' => 'Updates multiple products with enhanced descriptions',
                'category' => 'woocommerce',
                'permissions' => array('edit_products'),
                'inputs' => array(
                    'min_words' => array(
                        'type' => 'integer',
                        'description' => 'Minimum words for descriptions',
                        'default' => 500
                    )
                ),
                'outputs' => array(
                    'updated_count' => array(
                        'type' => 'integer',
                        'description' => 'Number of products updated'
                    )
                )
            ),
            array($this, 'bulk_update_products')
        );
    }
    
    public function bulk_update_products($args) {
        // Implementation for bulk updating products
        return array('updated_count' => 0);
    }
}

new WooCommerce_MCP_Extension();

性能考量

批量操作

批量更新已针对性能进行了优化
大型操作按批次处理
在批量操作期间会监控内存使用情况
长时间运行操作的进度跟踪

缓存

内置缓存机制，用于频繁访问的数据
可配置的缓存过期时间
数据更新时的缓存失效处理

速率限制

可配置的API速率限制
每用户速率限制
优雅地处理超出速率限制的情况

许可证

此插件根据GPL v2或更高版本授权。

支持

如需支持或有任何问题：

查看上面的故障排除部分
审查/回顾 WordPress功能API文档
检查一下 MCP适配器文档
在GitHub仓库上创建一个问题

📋（清单/待办事项列表）更新日志

版本3.0.0 - 当前发布版

新： 194+种工具 用于全面的WordPress管理
新与WooCommerce完全集成，具备产品编辑功能
新高级安全管理与漏洞扫描
新性能监控与缓存优化
新数据库管理和文件系统工具
新电子邮件和通知系统管理
新插件和主题高级管理工具
新网站管理和维护能力
新为更好地实现AI客户端集成，定制MCP服务器实现
改进了增强的错误处理和调试能力
改进后的更好的身份验证和权限管理
改进后的批量操作的性能优化

版本2.0.0

增强WooCommerce产品的批量更新功能
基于人工智能的产品描述生成（500+字）
智能产品分类系统
高级WooCommerce管理能力
针对产品、类别和定价的综合批量操作
更好的错误处理和日志记录
增强的安全性和权限检查
批量操作的性能优化

版本 1.0.0

首次发布
基本的网站信息管理能力
帖子管理功能
用户列表功能
插件信息检索
完全符合MCP协议规范

做出贡献

我们欢迎投稿！请参阅我们的贡献指南关于如何为该项目做出贡献的详细信息。

路线图

即将推出的功能

高级分析详细的WooCommerce分析与报告
自动化营销基于人工智能的营销内容生成
库存自动化自动化库存管理及提醒
客户洞察高级客户行为分析
多站点支持跨多个WordPress网站的管理

计划中的改进

增强的缓存系统
更完善的错误报告
更细粒度的权限
额外的WooCommerce集成
性能监控仪表板 # srz-mcp-server-wp

Srz MCP Server Wp

快速接入

详细介绍

SRZ MCP 服务器 WP

核心WordPress管理（31种工具）

站点管理（10种工具）

插件与主题工具（20款工具）

安全管理（20种工具）

性能与缓存（32种工具）

数据库与文件工具（25种工具）

电子邮件与通知（36款工具）

WooCommerce高级管理（20+工具）

WooCommerce 产品编辑器（10+种工具）

✨（星星眼表情，通常表示惊喜、赞叹或开心的情绪） 关键特性

全面的WordPress控制权

高级WooCommerce集成

AI赋能功能

开发者友好

🏗️ 建筑学

🚀 表情符号“🚀”在中文中通常被翻译为“火箭”或直接保留为“🚀”（因其本身具有直观的火箭形象）。所以，这个表情可以简单地理解为“火箭”或直接用“🚀”来表示。 快速入门

先决条件

安装

步骤1：安装插件

步骤2：启用开发模式

步骤3：安装Node.js依赖项

步骤4：设置应用程序密码

🔧 修理工具或扳手的象征 配置

Cursor 集成开发环境 (IDE) 配置

Claude桌面配置

VS Code 配置

测试连接

可用能力

网站信息

帖子管理

用户管理

系统信息

WooCommerce 能力

产品管理

批量操作

高级管理

订单管理

分类与标签

🎯 目标（靶心） 使用示例

使用Cursor IDE

使用 Claude Desktop

产品管理示例

使用Postman进行测试

安全

🔧 修理工具/螺丝刀 故障排除

常见问题

调试步骤

寻求帮助

🔧 创建扩展

快速入门

可用的钩子（或回调点）

发展

添加自定义能力

WooCommerce 扩展示例

性能考量

批量操作

缓存

速率限制

许可证

支持

📋（清单/待办事项列表） 更新日志

版本3.0.0 - 当前发布版

版本2.0.0

版本 1.0.0

做出贡献

路线图

即将推出的功能

计划中的改进

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP

✨（星星眼表情，通常表示惊喜、赞叹或开心的情绪）关键特性

🚀 表情符号“🚀”在中文中通常被翻译为“火箭”或直接保留为“🚀”（因其本身具有直观的火箭形象）。所以，这个表情可以简单地理解为“火箭”或直接用“🚀”来表示。快速入门

🔧 修理工具或扳手的象征配置

🎯 目标（靶心）使用示例

🔧 修理工具/螺丝刀故障排除

📋（清单/待办事项列表）更新日志