WordPress MCP 服务器

这是一个模型上下文协议（MCP）服务器，它使AI助手能够通过WordPress REST API与WordPress站点进行交互。此服务器提供了用于管理WordPress内容的编程工具，包括创建、检索和更新帖子。

功能

• 使用可定制的标题、内容和状态创建新的WordPress帖子
• 支持分页的WordPress帖子检索
• 更新现有帖子的内容或状态
• 使用WordPress应用程序密码进行安全认证
• 错误处理和详细的响应消息

预备条件

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

安装

1. 克隆此仓库：

git clone https://github.com/stefans71/wordpress-mcp-server.git
cd wordpress-server

2. 安装依赖项：

npm install

3. 构建服务器：

npm run build

WordPress配置

在使用服务器之前，您需要设置您的WordPress站点：

1. 确保您的WordPress站点已启用REST API（默认情况下在WordPress 4.7+中启用）
2. 创建一个应用程序密码：
   • 登录到您的WordPress管理面板
   • 转到用户 → 个人资料
   • 滚动到“应用程序密码”
   • 输入应用程序名称（例如，“MCP服务器”）
   • 单击“添加新应用程序密码”
   • 复制生成的密码（您将无法再次看到它）

MCP配置

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

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

可用工具

1. create_post

创建一个新的WordPress帖子。

参数：

• siteUrl（必需）：您的WordPress站点URL
• username（必需）：WordPress用户名
• password（必需）：WordPress应用程序密码
• title（必需）：帖子标题
• content（必需）：帖子内容
• status（可选）：帖子状态（'草稿'、'发布'或'私有'，默认为'草稿'）

示例：

{
  "tool": "create_post",
  "siteUrl": "https://example.com",
  "username": "admin",
  1. `password`: "xxxx xxxx xxxx xxxx",
  2. `title`: "我的第一篇帖子",
  3. `content`: "你好，世界！",
  4. `status`: "草稿"
}

2. get_posts

带有分页的WordPress帖子检索。

参数：

• siteUrl（必需）：您的WordPress站点URL
• username（必需）：WordPress用户名
• password（必需）：WordPress应用程序密码
• perPage（可选）：每页的帖子数量（默认：10）
• page（可选）：页码（默认：1）

示例：

{
  "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（可选）：新的帖子状态（'草稿'、'发布'或'私有'）

示例：

{
  "tool": "update_post",
  "siteUrl": "https://example.com",
  "username": "admin",
  "password": "xxxx xxxx xxxx xxxx",
  "postId": 123,
  "title": "更新后的标题",
  "content": "更新后的内容",
  "status": "发布"
}

响应格式

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

成功响应

{
  "success": true,
  "data": {
    // WordPress API响应数据
  }
}

错误响应

{
  "success": false,
  "error": "错误信息在这里"
}

错误处理

服务器处理各种类型的错误：

• 无效的请求格式
• 缺少必需的参数
• WordPress API错误
• 认证失败
• 网络问题

每个错误响应都包含描述性消息，以帮助诊断问题。

安全注意事项

• 始终使用HTTPS URL访问您的WordPress站点
• 使用应用程序密码而不是您的主要WordPress密码
• 保护好您的应用程序密码，不要与他人分享
• 考虑使用WordPress角色和权限来限制访问
• 定期轮换应用程序密码

开发

为了贡献于开发：

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 运行测试（如果有）
5. 提交拉取请求

许可证

本项目采用MIT许可证 - 查看LICENSE文件获取详细信息。

贡献

欢迎贡献！请随时提交拉取请求。通过贡献于本项目，您同意遵守其条款。