Comprehensive WordPress MCP Server

功能全面的 WordPress MCP 服务

一个功能全面的模型上下文协议（MCP）服务，可通过 WordPress REST API 让 AI 助手与 WordPress 网站交互。该服务提供了以编程方式管理 WordPress 各个方面的工具，包括文章、用户、评论、分类、标签和自定义端点。

功能

文章管理

• 创建、获取、更新和删除 WordPress 文章
• 按各种参数筛选文章
• 支持文章列表分页

用户管理

• 按 ID 或登录名获取用户信息
• 更新用户详细信息
• 删除用户

评论管理

• 创建、获取、更新和删除评论
• 按文章筛选评论
• 支持评论列表分页

分类法管理

• 管理分类和标签
• 创建、获取、更新和删除分类法
• 按别名查找分类和标签

网站信息

• 获取 WordPress 网站的一般信息

自定义请求

• 支持自定义 REST API 端点
• 支持自定义 HTTP 方法（GET、POST、PUT、DELETE）
• 支持自定义数据和参数

前提条件

• Node.js v18 或更高版本
• 已启用 REST API 的 WordPress 网站
• 用于身份验证的 WordPress 应用程序密码

安装

1. 克隆此仓库：

git clone [repository-url]
cd wordpress-mcp-server

2. 安装依赖项：

npm install

3. 构建服务：

npm run build

WordPress 配置

使用该服务之前，需要设置 WordPress 网站：

1. 确保 WordPress 网站已启用 REST API（WordPress 4.7+ 默认启用）
2. 创建应用程序密码：
   • 登录 WordPress 管理面板
   • 前往 Users → Profile
   • 向下滚动到“Application Passwords”
   • 输入应用程序名称（例如，“MCP Server”）
   • 点击“Add New Application Password”
   • 复制生成的密码（之后将无法再次查看）

MCP 配置

将服务添加到 MCP 设置文件中（通常位于 ~/AppData/Roaming/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）：

{
  "mcpServers": {
    "wordpress": {
      "command": "node",
      "args": ["path/to/wordpress-mcp-server/build/index.js"]
    }
  }
}

可用工具

文章管理

1. create_post

创建一篇新的 WordPress 文章。

参数：

• siteUrl（必需）：WordPress 网站 URL
• username（必需）：WordPress 用户名
• password（必需）：WordPress 应用程序密码
• title（必需）：文章标题
• content（必需）：文章内容
• status（可选）：文章状态（'draft'、'publish' 或 'private'，默认为 'draft'）

示例：

{
  "tool": "create_post",
  "siteUrl": "https://example.com",
  "username": "admin",
  "password": "xxxx xxxx xxxx xxxx",
  "title": "My First Post",
  "content": "Hello, world!",
  "status": "draft"
}

2. get_posts

分页获取 WordPress 文章。

参数：

• siteUrl（必需）：WordPress 网站 URL
• username（必需）：WordPress 用户名
• password（必需）：WordPress 应用程序密码
• perPage（可选）：每页文章数（默认值：10）
• page（可选）：页码（默认值：1）
• customParams（可选）：其他查询参数

示例：

{
  "tool": "get_posts",
  "siteUrl": "https://example.com",
  "username": "admin",
  "password": "xxxx xxxx xxxx xxxx",
  "perPage": 5,
  "page": 1
}

3. update_post

更新现有的 WordPress 文章。

参数：

• siteUrl（必需）：WordPress 网站 URL
• username（必需）：WordPress 用户名
• password（必需）：WordPress 应用程序密码
• postId（必需）：要更新的文章 ID
• title（可选）：新文章标题
• content（可选）：新文章内容
• status（可选）：新文章状态（'draft'、'publish' 或 'private'）

示例：

{
  "tool": "update_post",
  "siteUrl": "https://example.com",
  "username": "admin",
  "password": "xxxx xxxx xxxx xxxx",
  "postId": 123,
  "title": "Updated Title",
  "content": "Updated content",
  "status": "publish"
}

4. delete_post

删除一篇 WordPress 文章。

参数：

• siteUrl（必填）：WordPress 网站 URL
• username（必填）：WordPress 用户名
• password（必填）：WordPress 应用程序密码
• postId（必填）：要删除的文章 ID

示例：

{
  "tool": "delete_post",
  "siteUrl": "https://example.com",
  "username": "admin",
  "password": "xxxx xxxx xxxx xxxx",
  "postId": 123
}

用户管理

1. get_users

获取 WordPress 用户。

参数：

• siteUrl（必填）：WordPress 网站 URL
• username（必填）：WordPress 用户名
• password（必填）：WordPress 应用程序密码
• perPage（选填）：每页用户数（默认值：10）
• page（选填）：页码（默认值：1）

2. get_user

根据 ID 获取指定的 WordPress 用户。

参数：

• siteUrl（必填）：WordPress 网站 URL
• username（必填）：WordPress 用户名
• password（必填）：WordPress 应用程序密码
• userId（必填）：要获取的用户 ID

3. get_user_by_login

根据登录名获取 WordPress 用户。

参数：

• siteUrl（必填）：WordPress 网站 URL
• username（必填）：WordPress 用户名
• password（必填）：WordPress 应用程序密码
• userLogin（必填）：要获取的用户登录名

评论管理

1. get_comments

获取 WordPress 评论。

参数：

• siteUrl（必填）：WordPress 网站 URL
• username（必填）：WordPress 用户名
• password（必填）：WordPress 应用程序密码
• perPage（选填）：每页评论数（默认值：10）
• page（选填）：页码（默认值：1）
• postIdForComment（选填）：按文章 ID 筛选评论

2. create_comment

在文章中创建新评论。

参数：

• siteUrl（必填）：WordPress 网站 URL
• username（必填）：WordPress 用户名
• password（必填）：WordPress 应用程序密码
• postIdForComment（必填）：要发表评论的文章 ID
• commentContent（必填）：评论内容
• customData（选填）：其他评论数据

分类和标签管理

1. get_categories

获取 WordPress 分类。

参数：

• siteUrl（必填）：WordPress 网站 URL
• username（必填）：WordPress 用户名
• password（必填）：WordPress 应用程序密码
• perPage（选填）：每页分类数（默认值：10）
• page（选填）：页码（默认值：1）

2. create_category

创建新的 WordPress 分类。

参数：

• siteUrl（必填）：WordPress 网站 URL
• username（必填）：WordPress 用户名
• password（必填）：WordPress 应用程序密码
• categoryName（必填）：要创建的分类名称
• customData（选填）：其他分类数据（描述、父级等）

自定义请求

1. custom_request

向任意 WordPress REST API 端点发送自定义请求。

参数：

• siteUrl（必填）：WordPress 网站 URL
• username（必填）：WordPress 用户名
• password（必填）：WordPress 应用程序密码
• customEndpoint（必填）：API 端点路径
• customMethod（选填）：HTTP 方法（'GET'、'POST'、'PUT'、'DELETE'，默认值：'GET'）
• customData（选填）：POST/PUT 请求的数据
• customParams（选填）：GET 请求的 URL 参数

示例：

{
  "tool": "custom_request",
  "siteUrl": "https://example.com",
  "username": "admin",
  "password": "xxxx xxxx xxxx xxxx",
  "customEndpoint": "wp/v2/media",
  "customMethod": "GET",
  "customParams": {
    "per_page": 5
  }
}

响应格式

所有工具都按以下格式返回响应：

成功响应

{
  "success": true,
  "data": {
    // WordPress API response data
  },
  "meta": {
    // Optional metadata (pagination info, etc.)
  }
}

错误响应

{
  "success": false,
  "error": "Error message here"
}

安全注意事项

• 始终为 WordPress 网站使用 HTTPS URL
• 使用应用程序密码，而非 WordPress 主密码
• 妥善保管应用程序密码，不要与他人分享
• 考虑使用 WordPress 角色和权限来限制访问
• 定期轮换应用程序密码

开发

参与开发：

1. Fork 此仓库
2. 创建功能分支
3. 进行修改
4. 运行测试（如有）
5. 提交 pull request

如需在开发模式下自动重新编译：

npm run dev

许可证

本项目采用 ISC 许可证。

贡献

欢迎贡献！请随时提交 Pull Request。