本项目是一个代理服务,用于连接支持 Model Context Protocol (MCP) 的本地客户端(如 Claude Desktop, Cursor)与运行了 wordpress-mcp 插件 的远程 WordPress 网站。它使得本地的 LLM 客户端能够访问 WordPress 网站上的资源、工具和 Prompt。

项目简介

不同于直接安装在 WordPress 上的 wordpress-mcp 插件(这是真正的 MCP 服务器),本项目是一个 Node.js 包,它在本地运行,扮演客户端和远程 WordPress 网站之间的“桥梁”角色。本地 LLM 客户端通过标准输入/输出 (Stdio) 与本项目通信,本项目再通过 WordPress REST API 与远程 WordPress 网站上的 wordpress-mcp 插件通信。

主要功能点

  • 代理 MCP 请求: 接收本地 MCP 客户端发送的各种请求(如列出资源、读取资源、调用工具、获取 Prompt 等),并将这些请求转发给远程 WordPress 网站的 MCP 接口。
  • 转换通信协议: 将本地客户端使用的 Stdio 或其他协议请求转换为 HTTP 请求发送到远程 WordPress 网站,并将远程网站的 HTTP 响应转换为 MCP JSON-RPC 响应返回给客户端。
  • 处理认证: 使用提供的 WordPress API 密码或 WooCommerce API 密钥对请求进行认证,确保安全访问。
  • 日志记录: 支持将交互日志记录到文件,便于调试和问题排查。

安装步骤

  1. 在您的 WordPress 网站上安装 wordpress-mcp 插件。 这是必要的前提,本项目需要连接到该插件提供的远程 MCP 接口。您可以从 wordpress-mcp GitHub 仓库 获取插件信息。
  2. 无需全局安装本项目。 本项目通常通过 'npx' 命令直接运行,由您的 MCP 客户端负责启动。

服务器配置 (在 MCP 客户端中)

由于本项目是通过 Stdio 方式运行的本地服务,您需要在支持 MCP 的客户端中配置其启动命令和参数。配置通常是一个 JSON 对象,指定如何启动本项目以及传递必要的参数(主要通过环境变量)。

以下是配置所需的核心信息及参数说明(请根据您实际使用的客户端格式填写):

  • server name: 为您的 WordPress MCP 服务起一个名称,例如 'wordpress-mcp'。
  • command: 启动命令,通常是 'npx'。
  • args: 传递给 'command' 的参数数组,用于指定运行本项目包。例如 '["@Automattic/mcp-wordpress-remote"]'。
  • env: 一个包含环境变量的 JSON 对象,用于向本项目传递 WordPress 网站的连接信息和凭据。
    • 'WP_API_URL': 您的 WordPress 网站 URL (例如: 'https://example.com')。必需
    • 'WP_API_USERNAME': 您的 WordPress 用户名。必需
    • 'WP_API_PASSWORD': 您的 WordPress API 密码(不是您的登录密码,请在 WordPress 用户设置中生成)。必需
    • 'WOO_CUSTOMER_KEY': 如果您需要访问 WooCommerce MCP 资产,提供 WooCommerce Consumer Key。可选
    • 'WOO_CUSTOMER_SECRET': 如果您需要访问 WooCommerce MCP 资产,提供 WooCommerce Consumer Secret。可选
    • 'LOG_FILE': 日志文件的完整路径,用于记录交互过程。可选

请参考您使用的 MCP 客户端(如 Claude Desktop, Cursor 等)的文档,找到其 MCP 服务器配置文件的位置和具体格式,填入上述信息。

基本使用方法

配置完成后,重启您的 MCP 客户端。客户端会通过您提供的命令启动本项目作为后台进程,并通过 Stdio 与之通信。您现在可以通过 LLM 客户端界面访问和使用远程 WordPress 网站提供的 MCP 功能,例如:

  • 询问 LLM 关于您网站的内容(如果 wordpress-mcp 插件提供了资源访问功能)。
  • 让 LLM 调用 WordPress 或 WooCommerce 相关的工具(如果 wordpress-mcp 插件提供了工具)。

请注意,具体的交互方式取决于您的 MCP 客户端和 LLM 模型的能力。

信息

分类

网页与API