WordPress MCP Server

WordPress MCP Server

site icon
2025.01.29 0
WordPress 管理内容管理REST API 集成内容生成交流协作
WordPress MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,它使 AI 助手能够通过 WordPress REST API 与 WordPress 站点进行交互。该服务支持多个 WordPress 站点,提供安全认证,允许通过自然语言进行内容管理、文章操作和站点配置。
View on GitHub

Overview

基本能力

产品定位

WordPress MCP Server 是一个连接 AI 助手与 WordPress 站点的中间件,旨在通过自然语言简化 WordPress 站点的管理和操作。

核心功能

  • 多站点支持:同时连接多个 WordPress 站点
  • REST API 集成:完全访问 WordPress REST API 端点
  • 安全认证:使用应用密码进行安全的 API 访问
  • 动态端点发现:自动映射每个站点的可用端点
  • 灵活操作:支持 GET、POST、PUT、DELETE 和 PATCH 方法
  • 错误处理:优雅的错误处理并提供有意义的错误信息
  • 简单配置:易于维护的 JSON 配置文件

适用场景

  • 内容管理:创建、编辑、删除文章
  • 评论管理:查看、审核评论
  • 插件管理:检查、更新插件
  • 用户管理:创建、更新用户角色
  • 站点配置:检查主题、设置等

工具列表

  1. wp_discover_endpoints:映射 WordPress 站点上所有可用的 REST API 端点。
  2. 参数:站点别名(配置中定义)
  3. 返回:可用端点的列表及其方法和命名空间

  4. wp_call_endpoint:向 WordPress 站点执行 REST API 请求。

  5. 参数:站点别名、API 端点路径、HTTP 方法(GET、POST、PUT、DELETE、PATCH)、请求参数或正文数据

常见问题解答

  • 认证失败:确保使用正确的应用密码,且 WordPress 版本为 5.6 或更高,并使用 HTTPS。
  • 配置错误:检查配置文件路径和格式是否正确。
  • 网络错误:确保 WordPress 站点可访问且网络连接正常。

使用教程

使用依赖

  • Node.js 环境
  • WordPress 5.6 或更高版本
  • HTTPS 支持

安装教程

通过 Smithery 安装

npx -y @smithery/cli install server-wp-mcp --client claude

手动安装

npm install server-wp-mcp

调试方式

  1. 配置检查:确保 wp-sites.json 文件路径正确且格式无误。
  2. 环境变量:验证 WP_SITES_PATH 环境变量是否指向配置文件的绝对路径。
  3. 日志查看:运行服务时查看控制台输出以获取错误信息。

配置

获取应用密码

  1. 登录 WordPress 管理面板
  2. 转到 用户 → 个人资料
  3. 滚动到“应用密码”部分
  4. 输入应用名称(如“MCP Server”)
  5. 点击“添加新应用密码”
  6. 复制生成的密码

配置文件设置

创建 wp-sites.json 文件,包含站点详情:

{
    "myblog": {
        "URL": "https://myblog.com",
        "USER": "yourusername",
        "PASS": "abcd 1234 efgh 5678"
    }
}

与 Claude Desktop 集成

claude_desktop_config.json 中添加:

{
    "mcpServers": {
        "wordpress": {
            "command": "node",
            "args": ["path/to/server/dist/index.js"],
            "env": {
                "WP_SITES_PATH": "/absolute/path/to/wp-sites.json"
            }
        }
    }
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。