Wordpress Mcp Server

🚀 MCP WordPress 服务

🎯 为什么选择这个 MCP 服务？

将 WordPress 管理从复杂的管理面板转变为简单的对话：

❌ Before: Login → Admin Panel → Navigate → Click → Fill Forms → Save
✅ After:  "Create a new blog post about AI trends with SEO optimization"

主要优势：

• 🏆 功能最全面：73 个工具，而其他方案只有 20–30 个
• ⚡ 最快速设置：通过 DXT 只需 2 次点击即可安装 Claude Desktop
• 🔒 通过 CI 测试：在 Node 22/24 上运行了 2750 多项测试，并使用 CodeQL + Trivy 进行安全扫描
• 🎯 原生 TypeScript：100% 类型安全，提供一流的开发体验
• 🌐 多站点管理：可在一个地方管理最多 50 个 WordPress 站点

🚀 快速开始

不到 5 分钟即可启动并运行：

前置条件

• WordPress：版本 5.6+，已启用 REST API
• Claude Desktop：已安装最新版本
• 应用程序密码：在 WordPress 管理面板中生成

3 步完成设置

1️⃣ 生成 WordPress 应用程序密码

WordPress Admin → Users → Profile → Application Passwords → Add New

2️⃣ 安装 MCP 服务（任选其一）

选项 A：DXT 扩展（最简单）

# Download and install in Claude Desktop
curl -L https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt -o mcp-wordpress.dxt
# Then: Claude Desktop → Extensions → Install → Select DXT file

选项 B：全局安装 NPM

npm install -g mcp-wordpress

3️⃣ 测试连接

In Claude: "Test my WordPress connection"
Response: "✅ Authentication successful! Connected to: Your Site Name"

📺 观看 2 分钟的设置视频 | 📖 详细设置指南

⚡ 安装选项

🏆 推荐：Claude Desktop Extension (DXT)

最简单的安装方式——只需点击 2 次！

1. 下载： mcp-wordpress.dxt（3.4MB）
2. 安装：Claude Desktop → Extensions → Install → Select DXT file
3. 配置：输入 WordPress 站点 URL 和凭据

✅ 无需使用命令行 ✅ 轻松更新 ✅ 内置安全功能

📖 DXT 完整设置指南 →

🚀 替代方案：NPX（高级用户）

# Run directly - always latest version
npx -y mcp-wordpress

# Interactive setup wizard
npm run setup

🔧 其他选项

• 💻 NPM 设置 - 本地开发
• 🐳 Docker 设置 - 生产环境部署
• 🔧 手动构建 - 自定义构建

📋 配置

单站点（.env）

WORDPRESS_SITE_URL=https://myblog.com
WORDPRESS_USERNAME=admin
WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx

Claude Desktop 配置

{
  "mcpServers": {
    "mcp-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-wordpress"],
      "env": {
        "WORDPRESS_SITE_URL": "https://myblog.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

📖 完整配置指南 — 多站点、JWT、Docker、生产环境

🔐 身份验证

建议使用 WordPress 应用程序密码：

1. WordPress 管理后台 → 用户 → 个人资料 → 应用程序密码 → 添加新密码
2. 将生成的密码复制到配置中

其他方式：JWT、Basic Auth、API Key — 请参阅 身份验证配置

🌟 特别之处

功能	本服务	同类产品
可用工具	73 个工具	20-30 个工具
Claude Desktop DXT	✅ 点击 2 次即可安装	❌ 手动设置
多站点支持	✅ 最多支持 50 个站点	❌ 单站点
TypeScript	✅ 100% TypeScript，严格模式	⚠️ 部分支持或不支持
性能监控	✅ 实时分析	❌ 仅基础功能
测试覆盖率	✅ 2750+ 项测试，行覆盖率约 76%	⚠️ 有限
安全扫描	✅ CI 中集成 CodeQL + Trivy	⚠️ 未知

📋 可用工具（73 个工具）

内容管理

• 📝 文章（6 个工具）- 创建、编辑、删除和列出文章及自定义文章类型
• 📄 页面（6 个工具）- 管理静态页面和修订版本
• 🖼️ 媒体（5 个工具）- 上传和管理媒体库及文件
• 🔍 SEO（11 个工具）- 内容分析、元数据、Schema 标记、SERP 跟踪、关键词研究

用户与社区

• 👥 用户（6 个工具）- 用户管理和个人资料
• 💬 评论（7 个工具）- 评论审核和管理
• 🏷️ 分类法（10 个工具）- 分类目录和标签管理

站点管理

• ⚙️ 站点设置（6 个工具）- 站点配置和统计信息
• 🔐 身份验证（3 个工具）- 身份验证测试和管理
• ⚡ 缓存管理（4 个工具）- 性能缓存控制
• 📊 性能监控（6 个工具）- 实时指标和优化
• 🛠️ 系统（3 个工具）- 版本、插件和主题检查

📖 完整工具文档 | 在线 API 参考

🤖 示例

💬 "Create a new blog post about AI trends with SEO optimization"
💬 "Check my WordPress site performance and provide optimization recommendations"
💬 "Find all draft posts older than 30 days and provide a summary"
💬 "Batch update all client sites with the new privacy policy footer"
💬 "List all posts from my client-blog site"

📖 更多示例 | 实际工作流

🧪 测试与安全

npm test              # Full test suite (2750/2750 passing, 94 files)
npm run test:security # Security tests (371/371 passing)
npm run health        # System health check

📖 安全文档 — OWASP 覆盖范围、渗透测试、合规性

🛠️ 故障排除

npm run health         # System check
DEBUG=true npm run dev # Debug logging
npm run fix:rest-auth  # Fix WordPress 401 errors

错误	解决方案
401 Unauthorized	重新生成应用程序密码
403 Forbidden	检查用户角色（需要编辑者或更高权限）
404 Not Found	验证 WORDPRESS_SITE_URL
Connection Timeout	检查 WordPress REST API 访问权限

📖 完整故障排除指南

📚 文档

入门

• 快速入门指南 - 5 分钟内开始使用
• 安装指南 - 详细的设置说明
• 配置指南 - 所有配置选项
• 身份验证设置 - WordPress 身份验证方式

用户指南

• 基本用法 - 常见任务和工作流
• 高级工作流 - 复杂的自动化操作
• 多站点管理 - 管理多个站点
• 故障排除 - 常见问题及解决方案

集成指南

• Claude Desktop - 完整的 Claude 集成
• VS Code - VS Code 扩展设置
• Cline - Cline AI 助手集成
• 开发者指南 - 构建自己的 MCP 客户端

开发者文档

• API 参考 - 完整的工具文档
• 架构 - 系统设计与决策
• 参与贡献 - 开发指南
• 构建系统 - 构建与发布

部署与运维

• Docker 部署 - 容器部署
• 发布故障排除 - 解决发布问题
• 安全最佳实践 - 生产环境安全
• 缓存 - 性能与缓存指南

🔧 要求

• WordPress 5.0+，并启用 REST API
• 生产环境建议使用 HTTPS
• 启用应用程序密码（WordPress 5.6+）

角色	访问权限
管理员	可完全访问所有功能
编辑	文章、页面、评论、媒体
作者	自己的文章和媒体
投稿者	自己的文章（仅草稿）
订阅者	只读

🚀 后续步骤

准备好提升 WordPress 管理效率了吗？

1. 🏆 下载 DXT 扩展 - 最简单的设置方式（2 分钟）
2. ⚡ 试用 NPX 方式 - 高级用户设置（5 分钟）
3. 📚 探索所有工具 - 了解可以实现哪些功能
4. 💬 参与讨论 - 获取帮助并分享想法

---

🔗 类似项目

• Automattic WordPress MCP - Automattic 官方 WordPress MCP 服务

---

📋 更新日志

v3.3.21（2026 年 7 月）

• 🔒 安全强化 - SSRF 拒绝列表、强制使用 HTTPS、日志器脱敏、更新依赖最低版本
• 🐳 Docker 发布可靠性 - 设置有上限的发布任务超时，并修正挂起时的重试逻辑
• 📚 DOX 文档 - 建立分层的 AGENTS.md 契约树，为各目录提供工作指南

请参阅 CHANGELOG.md，查看完整的逐版本更新记录。

v3.3.14（2026 年 6 月）

• 🔒 安全更新 - 修补 Hono 中的中等严重性漏洞，更新 npm 捆绑包中允许列表内的安全公告
• 🧪 CI - 改进冒烟测试并验证 Node 24

v3.x 系列（2025–2026）

• 🏗️ 模块化架构 - 特定领域的操作模块与组合模式
• 🔄 容错能力 - 采用断路器模式，支持自动恢复
• 📊 2200+ 项测试 - 涵盖安全、缓存、服务、客户端、配置、工具、工具集和性能的全面测试套件
• ⚡ 缓存层 - CachedWordPressClient，支持配置 TTL；重复请求速度提升 50–70%
• 🌐 多站点 - 通过一个配置文件管理多达 50 个 WordPress 站点
• 🔐 4 种身份验证方式 - 应用密码（推荐）、JWT、Basic、API Key
• 🐳 Docker 与 DXT - 一键安装 Claude Desktop 扩展，并提供 Docker Hub 镜像

完整历史记录请参阅 CHANGELOG.md。

---

🙏 致谢

特别感谢 Stephan Ferraro 提供启发本项目实现的上游项目。

---