<div align="center"> <img src="logo.svg" alt="WPMCP Logo" width="400"/>

WordPress MCP 服务器

<p><strong>启用AI管理WordPress站点，如同专业开发者一般</strong></p> <p>超过190种工具，实现对WordPress的全面控制</p>

</div>

---

视频演示：https://youtu.be/6hwMqXQFKN0

💝 支持这个项目

如果这个项目对你有帮助，请考虑支持其发展：

加密货币捐赠

选择币种	选择网络	合约地址	存款地址
🪙 USDT (TetherUS)	🔗 TRX (Tron TRC20)	结尾为 jLj6t	TBJBb7fKyRdhqmWETyZoNP4X98mPk2Jxrt

您的支持有助于维护和改进这个项目！🙏

WPMCP服务器赋予AI代理对WordPress站点的完全控制。将其连接到Claude、Cline或任何兼容MCP的AI，并通过自然语言管理WordPress。

关键功能：

• ✅ 内容管理 - 文章、页面、媒体、用户、评论
• ✅ 文件系统访问 - 读写主题/插件文件
• ✅ 主题定制 - 创建子主题、修改样式、定制块主题
• ✅ 插件控制 - 激活、停用和修改插件
• ✅ 菜单管理 - 创建菜单、添加项目、分配位置
• ✅ 自定义内容类型 - 管理文章类型和分类法
• ✅ 短代码及计划任务 - 执行短代码、安排任务
• ✅ 小部件系统 - 管理侧边栏和小部件
• ✅ 数据库操作 - 执行查询、管理选项、检查表
• ✅ WooCommerce集成 - 商品、订单、客户、库存、报告
• ✅ Gutenberg块 - 块类型、模式、可重用块、模板
• ✅ 高级SEO - 站点地图、重定向、结构化数据、Open Graph、分析
• ✅ 安全监控 - 站点健康、更新、完整性检查、调试日志
• ✅ 性能优化 - 缓存管理、数据库优化、图像处理
• ✅ 备份与迁移 - 完整/部分备份、恢复、导出/导入、克隆
• ✅ 用户角色 - 自定义角色、权限、角色管理
• ✅ 全面安全 - 多层验证和自动备份

快速开始

1. 安装

npm i -g wpmcp@3.0.0

2. 配置

添加到您的MCP客户端（Claude Desktop、Cline等）：

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["-y", "wpmcp@3.0.0"],
      "env": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_PASSWORD": "your-app-password"
      }
    }
  }
}

3. 安装WordPress插件（必需）

1. 将wpmcp-plugin/wpmcp.zip安装到/wp-content/plugins/wpmcp-plugin/
2. 通过WordPress管理界面→插件→“WordPress MCP服务器插件”激活
3. 确保您具有edit_themes和edit_plugins权限

插件启用的功能：

• 文件系统操作（读、写、删除、复制、移动）
• 短代码执行
• 计划任务管理
• 所有高级WordPress功能

详见wpmcp-plugin/README.md以获取详细设置指南。

4. 使用

"创建一个名为'My Custom Theme'的子主题"
"激活Akismet插件"
"读取我的主题中的style.css文件"
"创建一篇关于WordPress的文章并发布"

可用工具（130+）

👉 详见WPMCP_TOOLS.MD以获取所有130个工具的完整详细列表。

类别	工具	您可以做什么
文章 (15)	创建、更新、删除、搜索、安排、发布、复制、批量	管理所有博客内容
页面 (4)	创建、更新、删除、层次结构	构建网站结构
媒体 (5)	上传、更新、删除、特色图片	管理图片和文件
用户 (4)	创建、更新、删除、角色	用户管理
分类 (4)	创建、更新、删除、层次结构	组织内容
标签 (2)	创建、获取	标记内容
评论 (4)	创建、更新、删除、审核	管理讨论
设置 (4)	获取、更新站点设置	配置WordPress
SEO (2)	元描述、关键词聚焦	搜索优化
文件系统 (8)	读、写、删除、复制、移动	编辑任何文件
主题管理器 (13)	激活、子主题、theme.json、模板	完全主题控制
插件管理器 (10)	激活、停用、读写文件	完全插件控制
菜单管理器 (8)	创建、添加项目、分配位置	完全导航控制
自定义类型 (7)	获取文章类型、分类法、管理术语	高级内容类型
短代码 (3)	列表、执行、检查存在	短代码系统
计划任务 (5)	列表、安排、取消安排、手动运行	任务调度
小部件 (6)	获取侧边栏、小部件、类型、更新	小部件管理
数据库 (6)	执行查询、管理选项、列出表	数据库操作
WooCommerce (15)	商品、订单、客户、库存、优惠券	电子商务管理
Gutenberg块 (12)	块类型、模式、可重用块、模板	现代块编辑器
安全 (7)	站点健康、更新、完整性、调试日志	安全监控
性能 (8)	缓存、优化、清理、图像处理	性能调整

您可以做什么

内容管理

"创建一篇关于AI的文章并发布"
"上传一张图片并将其设为文章5的特色图片"
"获取所有草稿文章"
"创建一个名为'关于我们'的新页面"

主题定制

"创建Twenty Twenty-Five的主题子主题"
"读取我主题中的functions.php文件"
"添加自定义CSS使标题变为蓝色"
"获取theme.json配置"
"列出我主题中的所有文件"

菜单管理示例

// 创建菜单
{
  "name": "主要导航",
  "description": "主站菜单"
}

// 添加菜单项
{
  "title": "首页",
  "url": "https://yoursite.com",
  "menus": 3
}

// 获取菜单位置
// 不需要参数

// 将菜单分配给位置
{
  "location": "primary",
  "menuId": 3
}

插件管理

"显示所有已安装的插件"
"激活Contact Form 7插件"
"读取WooCommerce主插件文件"
"停用Hello Dolly"
"检查Yoast SEO是否已安装"

菜单管理

"创建一个名为'主要导航'的新菜单"
"向菜单中添加一个主页链接"
"获取所有注册的菜单位置"
"将主要导航菜单分配给主要位置"
"显示主要菜单中的所有菜单项"

自定义文章类型及分类法

"显示所有注册的文章类型"
"获取'页面'文章类型的详细信息"
"获取所有分类法"
"显示所有分类"
"创建一个名为'Technology'的新分类"

短代码

"列出所有注册的短代码"
"执行[gallery ids='1,2,3']"
"检查'contact-form'短代码是否存在"

计划任务及安排任务

"显示所有已安排的计划任务"
"安排每日备份任务"
"手动运行WordPress计划任务"
"获取可用的计划任务时间表"

小部件

"获取所有小部件区域"
"显示所有可用的小部件类型"
"获取侧边栏中的小部件"
"列出未使用的小部件"

文件操作

"读取我主题中的style.css文件"
"在我的主题中创建一个新的custom.css文件"
"将functions.php复制为functions-backup.php"
"删除old-template.php并备份"

安全特性

所有操作都是安全的：

• ✅ 仅允许目录（主题、插件、上传）
• ✅ 仅安全文件扩展名（.php、.css、.js等）
• ✅ 恶意软件模式检测
• ✅ PHP语法验证
• ✅ 在更改前自动备份
• ✅ WordPress权限系统
• ✅ 文件大小限制（10MB）

WordPress认证

自托管WordPress：

1. 安装Basic Auth插件
2. 使用您的WordPress管理员用户名和密码

WordPress.com：

1. 需要Business计划或更高
2. 在设置→安全中生成应用密码

项目结构

src/tools/
├── posts.ts          # 15篇管理工具
├── pages.ts          # 4页工具
├── media.ts          # 5媒体工具
├── filesystem.ts     # 8文件系统工具
├── themes.ts         # 13主题管理工具
├── plugins.ts        # 10插件管理工具
├── menus.ts          # 8菜单管理工具
└── all-features.ts   # 用户、分类、标签、评论、设置、SEO

filesystem-plugin/
└── wpmcp-filesystem.php  # 文件操作所需

开发

# 克隆仓库
git clone https://github.com/RaheesAhmed/wordpress-mcp-server.git
cd wordpress-mcp-server

# 安装依赖
npm install

# 构建
npm run build

# 运行
npm start

测试

所有功能在实时WordPress上测试：

• ✅ 21/21测试通过
• ✅ 文件操作正常
• ✅ 主题管理验证
• ✅ 插件控制确认
• ✅ 安全验证

API示例

创建文章

{
  "title": "我的文章",
  "content": "<p>此处内容</p>",
  "status": "publish"
}

创建子主题

{
  "parentTheme": "twentytwentyfive",
  "childName": "我的自定义主题"
}

激活插件

{
  "plugin": "akismet/akismet"
}

读取主题文件

{
  "theme": "mytheme",
  "filePath": "functions.php"
}

写入文件

{
  "path": "wp-content/themes/mytheme/custom.css",
  "content": "/* 自定义样式 */",
  "createBackup": true
}

贡献

1. 分叉仓库
2. 创建功能分支（git checkout -b feature/name）
3. 提交更改（git commit -m '添加功能'）
4. 推送到分支（git push origin feature/name）
5. 打开拉取请求

许可证

MIT许可证 - 详见LICENSE

---

💝 支持这个项目

如果您发现这个项目有价值，请考虑支持其持续发展：

加密货币捐赠

币种	网络	合约地址	存款地址
🪙 USDT (TetherUS)	🔗 TRX (Tron TRC20)	结尾为 jLj6t	TBJBb7fKyRdhqmWETyZoNP4X98mPk2Jxrt

复制地址：

TBJBb7fKyRdhqmWETyZoNP4X98mPk2Jxrt

您的贡献有助于保持这个项目活跃和发展！感谢您的支持！🙏

---

为AI驱动的WordPress开发而构建 🚀