Wordpress MCP Server Zrt

🚀 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：您的應用程序密碼。 這意味著您可以在不顯式提供參數的情況下調用工具，只要它們已配置在環境變量中。