内容
# WordPress MCP 服务器
---
**注意：** 本项目完全由 AI 开发和支持。没有人工支持 — 问题和拉取请求由 AI 代理分类和回应。如果 AI 辅助软件不适合您，请不要介意 — 但您可能需要重新考虑，因为您已经使用的软件大多是 AI 辅助的。
---
一个模型上下文协议（MCP）服务器，允许 Claude 通过 WordPress REST API 管理 WordPress 网站。创建、编辑、发布帖子，管理分类和标签，查询站点配置 — 所有操作都可以在 Claude Desktop 或 Claude Code 中完成。
## 功能
- **帖子：** 创建、读取、更新、删除、发布、搜索
- **分类和标签：** 列出和筛选分类法
- **站点信息：** 查询站点配置和功能
- **应用密码：** 安全认证，无需硬编码凭证
- **Docker 就绪：** 多阶段构建，非 root，用户强化生产环境
## 快速入门
```bash
git clone https://github.com/wolffcatskyy/wordpress-mcp.git
cd wordpress-mcp
npm install
cp .env.example .env
# 编辑 .env 文件，填写您的 WordPress URL 和应用密码
npm run build
npm start
```
## Claude Desktop 配置
将以下内容添加到您的 Claude Desktop 配置文件（`~/Library/Application Support/Claude/claude_desktop_config.json`）：
```json
{
"mcpServers": {
"wordpress": {
"command": "node",
"args": ["/path/to/wordpress-mcp/dist/index.js"],
"env": {
"WORDPRESS_URL": "https://您的站点.com",
"WORDPRESS_USERNAME": "管理员",
"WORDPRESS_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
}
}
}
}
```
## 配置
| 变量 | 必需 | 描述 |
| --- | --- | --- |
| `WORDPRESS_URL` | 是 | WordPress 站点 URL（例如，`https://您的站点.com`） |
| `WORDPRESS_USERNAME` | 是 | WordPress 管理员用户名 |
| `WORDPRESS_PASSWORD` | 是 | 应用密码（在 WP 管理后台 > 用户 > 配置文件中生成） |
| `LOG_LEVEL` | 否 | `debug`、`info`、`warn`、`error`（默认：`info`） |
## 身份验证设置
本服务器使用 [WordPress 应用密码](https://make.wordpress.org/core/2020/11/05/application-passwords-integration-guide/)（内置于 WordPress 5.6+）：
1. 进入 **WordPress 管理后台 > 用户 > 您的配置文件**
2. 滚动到 **应用密码**
3. 输入名称：`Claude MCP`
4. 点击 **添加新的应用密码**
5. 复制生成的密码（空格可以保留）
6. 在您的配置文件中使用它作为 `WORDPRESS_PASSWORD`
## 可用工具
| 工具 | 描述 |
| --- | --- |
| `get_posts` | 列出帖子并筛选（搜索、状态、分页、排序） |
| `get_post` | 通过 ID 获取单个帖子 |
| `create_post` | 创建新帖子（标题、内容、摘要、状态、分类、标签） |
| `update_post` | 更新现有帖子 |
| `delete_post` | 删除/回收站帖子 |
| `publish_post` | 发布草稿或待审核帖子 |
| `get_categories` | 列出分类并可选搜索 |
| `get_tags` | 列出标签并可选搜索 |
| `get_site_info` | 获取站点名称、描述、URL、时区、功能 |
## Docker
```bash
# 构建和运行
docker compose up -d
# 查看日志
docker logs wordpress-mcp
```
## 开发
```bash
npm run dev # 使用 tsx 运行（热重载）
npm run build # 编译 TypeScript
npm start # 运行编译后的 JS
```
## 项目结构
```
src/
|-- index.ts # MCP 服务器入口点、工具定义、请求处理程序
|-- wordpress.ts # WordPress REST API 客户端（帖子、分类、标签、站点）
|-- utils/
|-- logger.ts # 结构化 JSON 日志输出到 stderr
```
## 贡献
本仓库中的每个问题都 **AI 就绪** — 结构化了完整的上下文、文件路径、实现指南和可用的 AI 提示。
参见 [CONTRIBUTING.md](CONTRIBUTING.md) 获取详细信息。
[**浏览问题 →**](https://github.com/wolffcatskyy/wordpress-mcp/issues)
## 许可证
MIT — 参见 [LICENSE](LICENSE)
