Wpe Ssai Cloudinary MCP

WP MCP服务器（WordPress+智能搜索+云计算）

WordPress插件，通过WordPress REST端点公开MCP工具，以便LLM客户端可以管理WordPress内容并将Cloudinary资产索引到Smart Search AI中。

此插件旨在安装在WordPress Admin中，并由支持MCP的客户端使用。

此插件提供什么

• MCP端点位于 wp-json/wpengine/v1/mcp
• 基于令牌的身份验证使用 X-MCP-Token 头球
• 用于网站信息、缓存清除和帖子创建/更新/读取/列表的WordPress工具
• 用于单个和批量Cloudinary资产索引的智能搜索AI索引工具

需求

• 具有管理员权限的WordPress网站
• 与WordPress安装兼容的PHP环境
• 智能搜索AI GraphQL端点URL和访问令牌
• 可以向HTTP端点发送JSON-RPC风格请求的MCP客户端

安装

1. 将此插件文件夹复制到您的WordPress插件目录中：

- wp-content/plugins/ssai-cloudinary-wpmcp

1. 在WordPress管理中，转到 Plugins.
2. 激活 WP MCP Server.

配置（WordPress管理员）

1. 首选 Settings -> WP Engine MCP.
2. 复制页面上显示的生成的MCP访问令牌。
3. 设置智能搜索AI凭据：

- 智能搜索URL（GraphQL端点） - 智能搜索访问令牌（承载令牌）

1. 保存设置。

MCP连接详细信息

• 端点：

- https://YOUR_SITE_URL/wp-json/wpengine/v1/mcp

• 方法：

- POST

• 所需标题：

- X-MCP-Token: YOUR_MCP_ACCESS_TOKEN

• 内容类型：

- application/json

JSON-RPC方法

端点支持以下MCP方法：

• initialize
• tools/list
• tools/call

如果调用未知方法，服务器将返回JSON-RPC错误代码 -32601.

可用工具

本地WordPress

• wpengine--get-current-site-info
• wpengine--purge-cache

WordPress帖子管理

• wpengine--create-post
• wpengine--update-post
• wpengine--get-post
• wpengine--list-posts

智能搜索+云索引

• wpengine--index-cloudinary-asset
• wpengine--bulk-index-cloudinary-assets

工具输入参考

wpengine--create-post

必修的：

• title （字符串）
• content （字符串）

可选：

• status (publish, draft, pending；默认为 publish)
• cloudinary_url （字符串）
• cloudinary_public_id （字符串）

wpengine--update-post

必修的：

• post_id （整数）

可选：

• title （字符串）
• content （字符串）
• status （字符串）

wpengine--get-post

必修的：

• post_id （整数）

wpengine--list-posts

可选：

• limit （整数，最大值100，默认值10）
• status （字符串，默认值 publish)

wpengine--index-cloudinary-asset

必修的：

• public_id （字符串）
• secure_url （字符串）
• resource_type （字符串，例如。 image, video, raw)
• format （字符串，例如。 jpg, png, mp4)

可选：

• tags （字符串数组）

wpengine--bulk-index-cloudinary-assets

必修的：

• assets （资产对象数组）

每项资产应包括：

• public_id （字符串）
• secure_url （字符串）
• resource_type （字符串）
• format （字符串）
• tags （字符串数组，可选）

请求示例

替换 YOUR_SITE_URL 和 YOUR_TOKEN.

初始化

curl -X POST "https://YOUR_SITE_URL/wp-json/wpengine/v1/mcp" \
  -H "Content-Type: application/json" \
  -H "X-MCP-Token: YOUR_TOKEN" \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"initialize",
    "params":{}
  }'

列出工具

curl -X POST "https://YOUR_SITE_URL/wp-json/wpengine/v1/mcp" \
  -H "Content-Type: application/json" \
  -H "X-MCP-Token: YOUR_TOKEN" \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/list"
  }'

使用Cloudinary图像创建帖子

curl -X POST "https://YOUR_SITE_URL/wp-json/wpengine/v1/mcp" \
  -H "Content-Type: application/json" \
  -H "X-MCP-Token: YOUR_TOKEN" \
  -d '{
    "jsonrpc":"2.0",
    "id":3,
    "method":"tools/call",
    "params":{
      "name":"wpengine--create-post",
      "arguments":{
        "title":"Launch Recap",
        "content":"Highlights from the event...",
        "status":"draft",
        "cloudinary_url":"https://res.cloudinary.com/demo/image/upload/sample.jpg",
        "cloudinary_public_id":"sample"
      }
    }
  }'

将Cloudinary资产索引到智能搜索中

curl -X POST "https://YOUR_SITE_URL/wp-json/wpengine/v1/mcp" \
  -H "Content-Type: application/json" \
  -H "X-MCP-Token: YOUR_TOKEN" \
  -d '{
    "jsonrpc":"2.0",
    "id":4,
    "method":"tools/call",
    "params":{
      "name":"wpengine--index-cloudinary-asset",
      "arguments":{
        "public_id":"events/hero-banner",
        "secure_url":"https://res.cloudinary.com/acme/image/upload/v1/events/hero-banner.jpg",
        "resource_type":"image",
        "format":"jpg",
        "tags":["event","hero","banner"]
      }
    }
  }'

建议的端到端工作流

1. 使用Cloudinary MCP集成上传资产。
2. 呼叫 wpengine--index-cloudinary-asset （或批量变体）在智能搜索AI中进行索引。
3. 使用智能搜索MCP通过自然语言查找资产。
4. 使用所选的Cloudinary图像URL创建或更新WordPress帖子。

备注

• MCP访问由WordPress选项中存储的一个令牌控制。
• 如果未配置智能搜索凭据，索引工具将返回错误。
• 帖子内容支持经过净化的HTML(wp_kses_post).