使用说明

项目简介

wp-mcp 是一个 MCP (Model Context Protocol) 服务器的实现，它作为一个桥梁，连接 WordPress 内容管理系统和大型语言模型（LLM）客户端。通过 wp-mcp，LLM 客户端可以调用预定义的工具来访问 WordPress 站点的数据，例如获取文章列表或页面列表，从而扩展 LLM 的知识库和功能。

请注意： 该项目目前处于开发阶段 (work in progress)。

主要功能点

列出 WordPress 文章 (wp_list_posts): 允许 LLM 获取 WordPress 站点上公开的文章列表，并以易于理解的格式返回文章的标题、状态、发布日期、链接和摘要等信息。
列出 WordPress 页面 (wp_list_pages): 允许 LLM 获取 WordPress 站点上的页面列表，并返回页面的标题、状态、发布日期、链接、父页面和菜单顺序等信息。

这些功能使得 LLM 能够：

理解 WordPress 网站的内容结构： 通过获取文章和页面列表，LLM 可以了解网站的基本信息架构。
检索 WordPress 网站的信息： LLM 可以根据用户的指令，利用这些工具获取特定的文章或页面信息，并用于问答、内容生成等任务。

安装步骤

环境准备：
- 确保本地已安装 Python 运行环境。
- 建议使用 'uv' 包管理器（如果未安装，请先安装 'uv'）。
- 确保本地运行一个 WordPress 实例，并可通过 'http://localhost:8888/' 访问。

克隆仓库（如果尚未克隆）：

git clone https://github.com/glendaviesnz/wp-mcp
cd wp-mcp/wp-server-python

创建并激活虚拟环境：

uv venv
source .venv/bin/activate

安装依赖：

uv pip install -r requirements.txt

测试运行服务器 (可选):
```
uv run wp.py
```
如果看到任何错误信息，请检查之前的步骤。此步骤主要用于验证环境配置是否正确，实际使用时通常由 MCP 客户端启动服务器。

服务器配置

要让 MCP 客户端（例如 Claude 桌面应用）连接到 wp-mcp 服务器，您需要在客户端的配置文件中添加服务器配置信息。以 'claude_desktop_config.json' 为例，您需要添加 'mcpServers' 部分，并在其中配置 'wordpress' 服务器：

{
  "mcpServers": {
    "wordpress": {  // 服务器名称，客户端配置中引用此名称
      "command": "uv", // 启动服务器的命令，这里使用 uv 包管理器
      "args": [      // 启动命令的参数列表
        "--directory", // 指定工作目录参数
        "/FULL/PATH/TO/wp-server-python", //  **请替换为 wp-server-python 文件夹的完整路径**，例如："/Users/yourname/Documents/wp-mcp/wp-server-python"
        "run",       // uv run 命令，用于运行 Python 脚本
        "wp.py"      // 要运行的 Python 脚本文件名
      ]
    }
  }
}

请务必将 '/FULL/PATH/TO/wp-server-python' 替换为 'wp-server-python' 文件夹在您本地文件系统中的实际完整路径。 例如，如果您的 'wp-mcp' 仓库克隆在 '/Users/yourname/Documents/' 目录下，那么路径可能是 '/Users/yourname/Documents/wp-mcp/wp-server-python'。

基本使用方法

配置 MCP 客户端： 按照上述 "服务器配置" 步骤，将 wp-mcp 服务器添加到您的 MCP 客户端配置中。
启动 MCP 客户端： 启动您的 MCP 客户端应用程序（例如 Claude 桌面应用）。客户端应该会自动检测并连接到 wp-mcp 服务器。
在 LLM 中使用工具： 在 LLM 客户端中，您可以使用自然语言指令来调用 wp-mcp 服务器提供的工具。例如，您可以询问：
- "列出 WordPress 上的文章"
- "获取 WordPress 网站的所有页面"
LLM 客户端会将这些指令转换为对 wp-mcp 服务器的工具调用，并将返回的 WordPress 数据用于后续的对话或任务。具体的工具调用方式和指令格式取决于您使用的 MCP 客户端的功能。

请注意： 由于 wp-mcp 依赖于本地 WordPress 实例，请确保 WordPress 正常运行并且可以通过 'http://localhost:8888/' 访问。

关键词