使用说明

项目简介

Claudeus WordPress MCP 是一个强大的 WordPress 管理工具，它基于 Model Context Protocol (MCP) 构建，允许 AI 模型与您的 WordPress 站点进行深度集成。通过 Claudeus WordPress MCP，您可以利用 AI 自动化内容生成、批量管理文章、进行 SEO 优化、管理 WooCommerce 商店以及进行多站点管理，极大地提升 WordPress 管理效率。

主要功能点

内容创作: 使用 AI 快速生成 SEO 优化的博客文章。
批量操作: 高效管理多个 WordPress 站点的海量文章。
AI SEO 优化: 利用 AI 分析和优化网站内容，提升搜索引擎排名。
WooCommerce 管理: 便捷管理商品、订单和销售数据。
多站点支持: 集中管理多个 WordPress 站点。
MCP 标准: 完全兼容 Model Context Protocol 标准，可与 MCP 客户端（如 Claude Desktop）无缝集成。
Inspector UI: 提供友好的 Inspector UI 界面，方便用户测试 Prompt、管理工具和资源，以及调试服务器通信。

安装步骤

环境准备:
- 确保已安装 Node.js (版本 >= 22.0.0) 和 pnpm。
- 确保已安装 TypeScript (版本 >= 5.0.0)。
- 确保 WordPress 站点已启用 REST API 功能。

克隆仓库:

git clone https://github.com/deus-h/claudeus-wp-mcp
cd claudeus-wp-mcp

安装依赖:
```
pnpm install
```
构建项目:
```
pnpm build
```
配置站点信息:
- 复制配置文件示例并进行编辑：
```
cp .env.example .env
cp wp-sites.json.example wp-sites.json
```
- 编辑 '.env' 文件，根据需要配置环境变量。
- 编辑 'wp-sites.json' 文件，配置 WordPress 站点的 URL、用户名、应用密码和认证类型 (basic 或 jwt)。
  - 获取应用密码: 登录 WordPress 后台，进入 "用户" -> "个人资料"，在 "应用密码" 部分创建并复制应用密码。
启动 MCP Inspector UI (可选):
```
pnpm inspector
```
- 这将启动 Inspector UI，您可以通过浏览器访问 'http://localhost:5173' 来进行交互测试。

服务器配置 (Claude Desktop 客户端)

要将 Claudeus WordPress MCP 服务器配置到 Claude Desktop 客户端，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'。

配置文件位置:

macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%\Claude\claude_desktop_config.json'

配置信息 (JSON 格式，添加到 'mcpServers' 字段中):

NPX 方式 (推荐开发环境使用)

{
  "mcpServers": {
    "claudeus-wp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claudeus-wp-mcp"
      ],
      "env": {
        "WP_SITES_PATH": "/absolute/path/to/your/wp-sites.json"  //  请替换为 wp-sites.json 文件的绝对路径
      }
    }
  }
}

Docker 方式 (推荐生产环境使用)

{
  "mcpServers": {
    "claudeus-wp-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network=host",
        "--mount", "type=bind,src=/absolute/path/to/your/wp-sites.json,dst=/app/wp-sites.json", // 请替换为 wp-sites.json 文件的绝对路径
        "--mount", "type=bind,src=/absolute/path/to/your/.env,dst=/app/.env",    // 请替换为 .env 文件的绝对路径
        "mcp/wordpress",
        "--config", "/app/wp-sites.json"
      ]
    }
  }
}

注意:

请务必将 '/absolute/path/to/your/wp-sites.json' 和 '/absolute/path/to/your/.env' 替换为您实际的 'wp-sites.json' 和 '.env' 文件的绝对路径。
如果您已经配置了其他 MCP 服务器，请不要直接覆盖配置文件，而是将 Claudeus WordPress MCP 的配置添加到现有的 'mcpServers' 对象中。

基本使用方法

启动 Claude Desktop 客户端。
连接 MCP 服务器: Claude Desktop 会自动检测并连接到配置的 Claudeus WordPress MCP 服务器。
使用 WordPress 工具: 在 Claude Desktop 的输入框下方，点击锤子 🔨 图标，即可访问 Claudeus WordPress MCP 提供的 WordPress 管理工具，例如：
- 创建、更新、删除 WordPress 文章和页面。
- 上传和管理媒体文件。
- 管理 WooCommerce 商品和订单。
- 发现 WordPress REST API 端点。
通过 Inspector UI 交互 (如果启动了 Inspector UI): 访问 'http://localhost:5173'，使用 Inspector UI 测试 Prompt、Tool 和 Resource 功能，并查看服务器通信日志。

提示: 请务必仔细阅读仓库的 README.md 文件，以获取更详细的配置和使用说明。

关键词