WordPress Feature API MCP 代理

使用说明

项目简介

WordPress Feature API MCP 代理是一个桥梁,它将 WordPress 强大的功能与 Model Context Protocol (MCP) 连接起来。通过这个代理服务器,你可以让支持 MCP 协议的 LLM 客户端(如 AI 助手)以标准化的方式访问和操作 WordPress 网站的功能,例如查询文章、管理用户等。它使得 LLM 应用能够更智能地与 WordPress 内容管理系统集成,实现更丰富和自动化的交互体验。

主要功能点

  • MCP 协议兼容: 完全遵循 Model Context Protocol 标准,确保与所有兼容 MCP 客户端的无缝对接。
  • 功能代理: 将 WordPress Feature API 注册的功能(资源和工具)转换为 MCP 协议下的资源和工具,无需修改现有 WordPress 功能。
  • 标准 JSON-RPC 通信: 使用 JSON-RPC 协议与 MCP 客户端通信,保证数据交换的标准化和高效性。
  • Stdio 传输协议: 通过标准输入/输出 (Stdio) 流与客户端建立连接,简化部署和配置。
  • 环境配置驱动: 服务器的 WordPress API 连接信息通过环境变量配置,方便管理和安全性。
  • 易于扩展: 基于 WordPress Feature API 构建,所有在 WordPress 中注册的功能都可以通过此代理暴露给 MCP 客户端。

安装步骤

  1. 克隆仓库: 首先,你需要克隆 'wp-feature-api' GitHub 仓库到本地开发环境。
  2. 进入代理目录: 使用命令行工具进入 'wp-feature-api/mcp-proxy' 目录。
  3. 安装依赖: 运行 'npm install' 命令安装项目所需的 Node.js 依赖包。

服务器配置

MCP 服务器配置信息(JSON 格式)主要用于 MCP 客户端连接服务器。以下是针对 WordPress Feature API MCP 代理的配置示例,请根据你的实际环境进行调整:

{
  "serverName": "WordPress Feature API Proxy",
  "transport": "stdio",
  "command": "node",
  "args": [
    "mcp-proxy/build/index.js"
  ],
  "environmentVariables": {
    "WP_API_URL": "你的 WordPress 站点 API 地址",
    "WP_API_USERNAME": "你的 WordPress API 用户名",
    "WP_API_PASSWORD": "你的 WordPress API 密码"
  },
  "description": "连接到 WordPress Feature API 的 MCP 代理服务器。"
}
  • 'serverName': 服务器的名称,可以自定义。
  • 'transport': 传输协议,这里固定为 'stdio'。
  • 'command': 启动服务器的命令,通常为 'node'。
  • 'args': 启动命令的参数,指定 MCP 代理服务器的入口文件路径 'mcp-proxy/build/index.js'。
  • 'environmentVariables': 重要,配置连接 WordPress API 的环境变量:
    • 'WP_API_URL': 你的 WordPress 站点的 REST API 根地址,例如 'https://your-wordpress-site.com'。请确保地址正确,不包含末尾的斜杠 '/'。
    • 'WP_API_USERNAME': 用于 API 认证的 WordPress 用户名。建议创建一个专门用于 API 访问的用户,并赋予适当的权限。
    • 'WP_API_PASSWORD': 与上述用户名对应的 WordPress 密码。

基本使用方法

  1. 启动 MCP 代理服务器: 在 'wp-feature-api/mcp-proxy' 目录下,确保已配置好环境变量 'WP_API_URL', 'WP_API_USERNAME', 'WP_API_PASSWORD' 后,运行命令 'npm run start' 启动 MCP 代理服务器。
  2. 配置 MCP 客户端: 在你的 MCP 客户端应用中,根据上述 “服务器配置” JSON 信息进行配置,指定连接到 Stdio 传输协议的服务器。
  3. 连接与交互: 客户端成功连接后,即可通过 MCP 协议发送请求到代理服务器,例如列出可用的工具 (ListToolsRequest) 或调用特定工具 (CallToolRequest)。服务器会将请求转发到 WordPress Feature API,并将响应返回给客户端。

注意: 请确保你的 WordPress 站点已安装并启用了 WordPress Feature API 插件,并且 WordPress REST API 访问已正确配置和授权。

服务器信息