使用说明

项目简介

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 访问已正确配置和授权。

信息

分类

网页与API