Mcp Wordpress

🚀 WordPress MCP 服务器

WordPress MCP 服务器是一个用于与启用了 REST API 的 WordPress 站点交互的 Model Context Protocol (MCP) 服务器。它提供了从任何 WordPress 安装中获取文章、页面、类别和站点信息的工具，方便开发者进行相关数据的获取与操作。

🚀 快速开始

使用此 WordPress MCP 服务器前，需确保满足一定的先决条件，完成安装与配置，之后就能轻松使用相关功能。

✨ 主要特性

• 可与启用了 REST API 的 WordPress 站点进行交互。
• 提供多种工具，能获取文章、页面、类别和站点信息。
• 具备强大的错误处理功能，可应对多种错误情况。

📦 安装指南

安装步骤如下：

1. 安装 UV（通用虚拟环境）：

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

2. 克隆仓库：

   git clone 
   cd wordpress
   

3. 创建并激活虚拟环境：

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

4. 使用 UV 安装依赖项：

   uv add "mcp[cli]" httpx
   

先决条件

• Python 3.13
• 启用了 REST API 的 WordPress 网站
• UV 包安装程序（推荐）

🔧 配置

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

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

💻 使用示例

基础用法

使用 Claude for Desktop：

• 启动服务器：

uv run main.py

• 在 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

• 添加文件到配置中：

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