WordPress MCP 服务器

一个允许将内容发布到 WordPress 站点的机器通信协议 (MCP) 服务器。

功能

• 将文章发布到 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：提供一个带有 base64 编码图像数据的 image_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 应用程序密码

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