使用说明

项目简介

本项目旨在将 WordPress 转化为 MCP 服务器，同时使 WP-CLI 成为 MCP 客户端（Host），从而在 WordPress 开发环境中实现 AI 驱动的自动化和内容交互。开发者可以通过 WP-CLI 命令，利用 AI 功能直接操作 WordPress 站点，无需依赖在线网站或 REST API 接口。

主要功能点

WordPress MCP 服务器:
- 在 WordPress 中实现了 MCP 服务器接口。
- 提供对 WordPress 内容（如文章、页面、媒体）的资源访问。
- 集成了 WordPress 常用操作的工具（如内容创建、媒体处理）。
- 提供 WordPress 配置和站点状态的上下文信息。
WP-CLI MCP 客户端:
- 在 WP-CLI 框架内实现了 MCP 客户端功能。
- 新增 'wp ai' 命令用于 AI 交互。
- 可以与本地和远程的 LLM 提供商集成。
- 通过多种传输层与 MCP 服务器通信。

安装步骤

检查 WP-CLI 版本: 确保 WP-CLI 版本为 v2.11 或更高。建议使用最新版本，可以使用 'wp cli update' 命令更新。为了更好支持最新的 PHP 版本，可以使用 nightly 版本 'wp cli update --nightly'。

安装 ai-command 包: 运行以下 WP-CLI 命令安装 ai-command 包的最新开发版本：

wp package install swissspidy/ai-command:dev-main

安装 AI Services 插件: 本插件依赖 WordPress 的 AI Services 插件，请确保已安装并激活该插件。

服务器配置

MCP 服务器通过 'wp mcp server' 命令进行管理。MCP 客户端需要配置 MCP 服务器的连接信息才能正常工作。以下是一些 MCP 服务器配置示例，可以通过 'wp mcp server add' 命令添加到 WP-CLI 配置中。

{
  "servers": {
    "wordpress": {
      "name": "wordpress",
      "command": "WordPress"
    },
    "wp-cli": {
      "name": "wp-cli",
      "command": "WP-CLI"
    },
    "filesystem-server": {
      "name": "filesystem-server",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/folder"]
      // command: MCP 服务器的启动命令，这里使用 npx 启动 @modelcontextprotocol/server-filesystem
      // args: 启动命令的参数，包括 -y (确认安装) 和服务器包名及允许访问的文件夹路径
    },
    "remote-http-server": {
      "name": "remote-http-server",
      "command": "https://your-mcp-server.com/mcp"
      // command: 远程 MCP 服务器的 URL 地址
    }
  }
}

配置说明:

'wordpress': 内置的 WordPress MCP 服务器。'command' 设置为 'WordPress' 即可。
'wp-cli': 内置的 WP-CLI MCP 服务器。 'command' 设置为 'WP-CLI'。
'filesystem-server': 文件系统 MCP 服务器示例，使用 'npx' 运行 '@modelcontextprotocol/server-filesystem'，需要指定允许访问的文件夹路径。
'remote-http-server': 远程 HTTP MCP 服务器示例，'command' 直接设置为服务器的 HTTP 地址。

使用 'wp mcp server add <server-name> <command> [args]' 命令添加服务器配置，例如：

'wp mcp server add wordpress WordPress' 添加 WordPress 内置服务器。
'wp mcp server add filesystem-server "npx -y @modelcontextprotocol/server-filesystem /my/allowed/folder/"' 添加文件系统服务器。
'wp mcp server add remote-http-server "https://your-mcp-server.com/mcp"' 添加远程 HTTP 服务器。

使用 'wp mcp server list' 命令查看已配置的 MCP 服务器列表。使用 'wp mcp server remove <server-name>' 命令移除已配置的 MCP 服务器。

基本使用方法

使用 'wp ai <prompt>' 命令与 AI 进行交互。

示例:

获取最近三篇文章的标题:

wp ai "What are the titles of my last three posts?"

使用文件内容创建一篇新的博客文章:

wp ai "Take file foo.txt and create a new blog post from it"

更多 'wp ai' 和 'wp mcp server' 命令的详细用法，请参考仓库 README.md 文件或使用 'wp help ai' 和 'wp help mcp server' 命令查看帮助信息。

关键词