项目简介

WordPress MCP服务器是一个强大的后端服务,专为连接AI代理(如Claude, LangGraph)和WordPress网站而设计。它通过标准的Model Context Protocol (MCP) 将WordPress的复杂操作转化为AI可理解的工具,让AI能够通过自然语言指令来创建文章、管理页面、上传媒体、管理用户和设置等,实现WordPress网站的智能自动化管理。

主要功能点

  • 全面的WordPress管理: 提供超过49种工具,覆盖文章、页面、媒体、用户、分类、标签、评论以及站点设置的完整CRUD(创建、读取、更新、删除)操作。
  • AI友好接口: 将WordPress REST API抽象为一系列清晰、易于AI调用的工具,支持AI通过自然语言进行交互。
  • 类型安全与健壮性: 采用TypeScript实现,确保代码类型安全,并包含完善的错误处理和数据验证机制。
  • 多功能操作: 支持批量操作、SEO元数据设置、特色图片管理等高级功能。

安装步骤

推荐使用 npm 全局安装或通过 npx 直接运行:

  1. 全局安装 (推荐):
    npm i -g wpmcp
  2. 通过 npx 运行:
    npx wpmcp

如果您选择从GitHub克隆,请执行以下步骤:

  1. 克隆仓库并进入目录:
    git clone https://github.com/RaheesAhmed/wordpress-mcp-server.git
    cd wordpress-mcp-server
  2. 安装依赖:
    npm install
  3. 配置WordPress凭据(将 '.env.example' 复制为 '.env' 并编辑):
    cp .env.example .env
    # 编辑 .env 文件,填入您的WordPress URL、用户名和密码
  4. 构建项目:
    npm run build
  5. 运行服务器:
    npm start

服务器配置 (MCP客户端使用)

MCP客户端需要配置服务器的启动命令和必要的环境变量才能连接。以下是一个示例配置,您需要根据您的MCP客户端(如Claude Desktop, Cline)进行调整:

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",                         // MCP服务器的启动命令
      "args": ["-y", "wpmcp"],                  // 启动命令的参数
      "env": {
        "WORDPRESS_URL": "https://yourblog.com",       // 您的WordPress网站URL
        "WORDPRESS_USERNAME": "admin",                 // 具有API访问权限的WordPress用户名
        "WORDPRESS_PASSWORD": "your-app-password"      // 您的WordPress应用程序密码(推荐)或常规密码
      }
    }
  }
}

WordPress认证说明:

  • 自托管WordPress (localhost): 安装 Basic Auth plugin 插件,并使用您的WordPress用户名和密码。
  • WordPress.com: 需要商务版或更高套餐,并在设置 → 安全 → 应用程序密码中生成应用程序密码。

基本使用方法

一旦MCP服务器配置并启动,您的AI代理就可以通过自然语言向其发送指令,例如:

  • "创建一篇关于AI的1000字博客文章并发布。"
  • "获取所有草稿文章。"
  • "上传一张图片并将其设置为文章ID为123的特色图片。"
  • "列出所有WordPress用户。"
  • "获取所有已安装的插件。"

信息

分类

AI与计算