mcp-for-wordpress

🚀 WordPress MCP 集成

这是一款经过优化的 TypeScript SDK，专为 WordPress 集成量身定制。借助该 SDK，您可以通过 WordPress REST API，运用 Model Context Protocol (MCP) 协议与 WordPress 站点进行交互。

🚀 快速开始

本 SDK 允许您通过 WordPress REST API 使用 MCP 协议与 WordPress 站点进行交互，实现创建、获取和更新文章等操作。

✨ 主要特性

• 创建新的 WordPress 文章
• 获取现有的 WordPress 文章
• 更新现有的 WordPress 文章

📦 安装指南

1. 克隆此仓库
2. 安装依赖项：

npm install

📚 详细文档

配置

有以下两种方式来配置 WordPress 集成：

1. 环境变量

设置以下环境变量：

• WORDPRESS_SITE_URL：您的 WordPress 站点 URL
• WORDPRESS_USERNAME：WordPress 用户名
• WORDPRESS_PASSWORD：WordPress 应用程序密码

2. 请求参数

在调用工具时直接提供凭证。

安全注意事项

出于安全考虑，建议使用 WordPress 应用程序密码而不是主账户密码。您可以在 WordPress 管理面板的用户 → 安全 → 应用程序密码部分生成应用程序密码。

可用工具

create_post

创建新的 WordPress 文章。 参数：

• siteUrl：（可选，如果在环境中设置）WordPress 站点 URL
• username：（可选，如果在环境中设置）WordPress 用户名
• password：（可选，如果在环境中设置）WordPress 应用程序密码
• title：文章标题
• content：文章内容
• status：（可选）'draft' | 'publish' | 'private'（默认：'draft'）

示例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_post",
    "arguments": {
      "title": "我的新文章",
      "content": "你好，世界！",
      "status": "draft"
    }
  }
}

get_posts

获取 WordPress 文章。 参数：

• siteUrl：（可选，如果在环境中设置）WordPress 站点 URL
• username：（可选，如果在环境中设置）WordPress 用户名
• password：（可选，如果在环境中设置）WordPress 应用程序密码
• perPage：（可选）每页文章数量（默认：10）
• page：（可选）页码（默认：1）

示例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_posts",
    "arguments": {
      "perPage": 5,
      "page": 1
    }
  }
}

update_post

更新现有的 WordPress 文章。 参数：

• siteUrl：（可选，如果在环境中设置）WordPress 站点 URL
• username：（可选，如果在环境中设置）WordPress 用户名
• password：（可选，如果在环境中设置）WordPress 应用程序密码
• postId：要更新的文章 ID
• title：（可选）新文章标题
• content：（可选）新文章内容
• status：（可选）'draft' | 'publish' | 'private'

示例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_post",
    "arguments": {
      "postId": 123,
      "title": "更新后的文章标题",
      "status": "publish"
    }
  }
}

运行服务器

启动 WordPress MCP 服务器：

npm run start

注意事项

⚠️ 重要提示

确保环境变量正确设置，以便工具能够正常连接到 WordPress 站点。

💡 使用建议

在调用 API 时，确保提供有效的凭证以避免权限问题。