WordPress MCP Server

WordPress MCP 服务

一种机器通信协议（MCP）服务，可将内容发布到 WordPress 站点。

功能

• 向 WordPress 发布文章
• 测试 WordPress 连接
• 创建、检索和管理 WordPress 分类和标签
• 发布时自动处理分类和标签的创建
• 支持通过 URL 或 base64 编码的数据设置特色图片
• 可作为独立 FastAPI 服务和 MCP 服务运行
• 支持通过环境变量配置 WordPress 凭据

设置

1. 使用 UV 创建虚拟环境：

   uv venv
   .venv\Scripts\activate
   

2. 安装依赖项：

   uv pip install -r requirements.txt
   

3. 配置 WordPress 凭据：

   • 将 .env.example 重命名为 .env（或新建一个 .env 文件）
   • 填入 WordPress 站点 URL、用户名和应用程序密码

用法

作为 MCP 服务

以 MCP 模式运行服务：

python main.py --mcp

作为独立 API

将服务作为独立的 FastAPI 应用运行：

python main.py

API 的访问地址为 http://localhost:8000

API 端点

• GET / - 根端点
• GET /wp-config - 获取环境变量中的 WordPress 配置
• POST /get-categories - 获取 WordPress 中的所有分类
• POST /get-tags - 获取 WordPress 中的所有标签
• POST /test-connection - 测试 WordPress 连接
• POST /publish-article - 向 WordPress 发布文章

MCP 工具

• PUBLISH_ARTICLE - 使用分类和标签 ID 向 WordPress 发布文章
• PREPARE_ARTICLE_METADATA - 检查分类和标签是否已存在；如果不存在，则创建它们并返回对应 ID
• TEST_CONNECTION - 测试与 WordPress 站点的连接

分类和标签管理

WordPress MCP 服务现在支持高级分类和标签管理：

使用 PREPARE_ARTICLE_METADATA

此工具可以：

1. 检查 WordPress 站点上是否存在指定分类和标签
2. 自动创建不存在的分类或标签
3. 返回所有分类和标签的 ID，供 PUBLISH_ARTICLE 使用

示例工作流：

1. 使用分类和标签名称调用 PREPARE_ARTICLE_METADATA
2. 获取对应的 ID
3. 使用这些 ID 调用 PUBLISH_ARTICLE 发布内容

特色图片支持

WordPress MCP 服务现在支持为文章添加特色图片：

在 PUBLISH_ARTICLE 中使用图片

可以通过两种方式为文章添加特色图片：

1. 通过 URL：提供 image_url 参数，其中包含图片的直接链接

   "image_url": "https://example.com/path/to/image.jpg"
   

2. 通过 Base64：提供 image_base64 参数，其中包含经过 base64 编码的图片数据

   "image_base64": "iVBORw0KGgoAAAANSUhEUgAA..."
   

3. 自定义文件名：可选地为上传的图片指定文件名

   "image_filename": "my-custom-image-name.jpg"
   

服务将：

• 下载图片（如果提供了 URL），或解码 base64 数据
• 将图片上传到 WordPress
• 将图片设为文章的特色图片
• 在响应中返回媒体 ID

使用独立 API

使用独立 API 时，可以通过以下方式提供特色图片：

• 使用 image 表单字段上传文件
• 使用 image_url 表单字段提供 URL

环境变量支持

所有工具现在都支持将 .env 文件中的环境变量用作默认值：

• WP_SITE_URL - WordPress 站点 URL
• WP_USERNAME - WordPress 用户名
• WP_PASSWORD - WordPress 应用程序密码

这意味着如果已在环境中设置这些参数，调用工具时便无需显式提供它们。