WordPress MCP 服务器

一个用于与 WordPress 站点交互的模型上下文协议 (MCP) 服务器。该服务器提供工具，用于从任何启用了 REST API 的 WordPress 安装中获取文章、页面、分类和站点信息。

前提条件

• Python 3.13
• 启用了 REST API 的 WordPress 站点
• UV 包管理器（推荐）

安装

1. 安装 UV (Universal Virtualenv):

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

配置

1. 在项目根目录中创建一个 .env 文件:

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

使用

使用 Claude for Desktop:

• 首先，启动服务器:

uv run main.py

• 在 Claude for Desktop 中，转到 Settings > Developer
• 点击 "Edit Config"
• 使用 VSCode 在 Mac/Windows 中编辑配置的替代方法:

  # For Mac Users
  code ~/Library/Application\ Support/Claude/claude_desktop_config.json
  
  # For Windows Users
  code $env:AppData\Claude\claude_desktop_config.json
  

• 将文件添加到配置:

{
    "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 身份验证问题