MCP Wordpress

🚀 WordPress MCP 服務器

WordPress MCP 服務器是一個基於 Model Context Protocol (MCP) 的工具，可與啟用 REST API 的 WordPress 站點進行交互。藉助該服務器，你能輕鬆從任何 WordPress 安裝中獲取文章、頁面、類別和站點信息。

🚀 快速開始

在使用 WordPress MCP 服務器之前，需確保滿足以下先決條件，並完成安裝和配置步驟。

✨ 主要特性

• 與啟用 REST API 的 WordPress 站點無縫交互。
• 提供豐富工具，可獲取文章、頁面、類別和站點信息。
• 具備強大的錯誤處理功能，應對各類異常情況。

📦 安裝指南

1. 安裝 UV（通用虛擬環境）

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 克隆倉庫

git clone <repository-url>
cd wordpress

3. 創建並激活虛擬環境

uv venv
source .venv/bin/activate  # 在 Windows 上使用 `.venv\Scripts\activate`

4. 使用 UV 安裝依賴項

uv add "mcp[cli]" httpx

📚 詳細文檔

配置

在項目根目錄中創建一個 .env 文件，內容如下：

WORDPRESS_URL="https://your-wordpress-site.com"

使用方法

使用 Claude for Desktop

1. 啟動服務器

uv run main.py

2. 在 Claude for Desktop 中配置
   • 轉到 設置 > 開發者。
   • 點擊“編輯配置”。
   • 另一種編輯配置的方法（使用 VSCode 在 Mac/Windows 上）：

     # 對於 Mac 用戶
     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
     
     # 對於 Windows 用戶
     code $env:AppData/Claude/claude_desktop_config.json
     

3. 添加文件到配置中

{
    "mcpServers": {
        "weather": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/wordpress",
                "run",
                "main.py"
            ]
        }
    }
}

可測試工具

• fetch_wordpress_info：獲取基本站點信息
• fetch_posts：獲取最近文章
• fetch_categories：列出所有類別
• fetch_posts_by_category：獲取特定類別的文章
• fetch_pages：獲取站點頁面
• fetch_post_by_id：獲取特定文章
• fetch_page_by_id：獲取特定頁面

錯誤處理

服務器包含以下強大的錯誤處理功能：

• 無效的 JSON 響應
• 網絡錯誤
• WordPress API 錯誤
• 無效 URL
• API 身份驗證問題