🚀 WordPress MCP 服务器

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 端点

MCP 工具

• PUBLISH_ARTICLE：将文章发布至 WordPress 指定分类目录及标签 ID。
• 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 发布内容。

特色图片支持

在 PUBLISH_ARTICLE 中使用图片

您可以通过以下两种方式添加特色图片：

• 通过 URL：提供 image_url 参数，指向图片的直接链接。

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

• 通过 Base64：提供 image_base64 参数，包含 Base64 编码的图片数据。

"image_base64": "iVBORw0KGgoAAAANSUhEUgAA..."

• 自定义文件名：可选指定上传后的图片文件名。

"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：您的应用程序密码。 这意味着您可以在不显式提供参数的情况下调用工具，只要它们已配置在环境变量中。