WordPress 站点管家连接器(wordpress-site-manager)
开发者:牛魔科技工作室
连接你自己的 WordPress 网站后台(官方 REST API + 应用密码),用自然语言写文章、管评论、传媒体、看站点概况。操作只作用于你自填的那个站点;应用密码在 WP 后台生成,仅保存在本机。
- source ID:
wordpress-site-manager - 运行形态:local stdio MCP(本机进程,无服务器、无端口、不开放外网入口)
- 依赖:零第三方依赖,纯 Python 标准库
- 发布形态:
uvx wb-wordpress-site-manager-mcp==1.0.0(PyPI 包与连接器同源发布)
一、前置安装(只需一次)
本连接器通过 uvx 启动,需要本机已安装 uv:
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
验证:uvx --version。未安装 uv 时连接器无法启动——这是唯一的环境前置。
二、连接配置(约 5 分钟)
- 登录你的 WordPress 后台(
https://你的站点/wp-admin)。 - 打开 用户 → 个人资料,拉到 应用密码 区域;在名称框输入
WorkBuddy,点 添加新应用密码。 - 复制生成的密码(形如
xxxx xxxx xxxx xxxx xxxx xxxx,只显示一次)。 - 回到 WorkBuddy 连接器卡片点「连接」,依次填入:
- 站点地址:
https://你的站点(根地址,不带/wp-admin、不带尾斜杠) - 登录用户名:后台登录用的用户名(不是昵称)
- 应用密码:上一步复制的密码(带不带空格都行)
- 站点地址:
权限对照表(最小权限)
| 想用的能力 | 账号最低角色 | 对应工具 |
|---|---|---|
| 读文章/评论/媒体、看概况 | 订阅者即可读已发布内容 | post_list post_get comment_list media_list term_list site_overview |
| 写草稿、传媒体 | 投稿者(contributor) | post_create(draft) media_upload comment_reply |
| 直接发布/更新/删除文章 | 作者(author) | post_create(publish) post_update post_delete |
| 管理评论(通过/标垃圾/删) | 编辑(editor) | comment_moderate |
| 管理分类/标签 | 作者及以上 | post_create/post_update 的自动建词、term_list |
应用密码的权限 = 该账号自身权限,不会放大。建议日常用「作者」角色的账号连接。
看不到「应用密码」区域? 该功能只在 https 站点(或 localhost)显示;某些安全插件会隐藏它,可暂时停用相关插件生成后再启用。
三、工具清单(13 个)
| 工具 | 说明 | 写操作 |
|---|---|---|
config_selftest |
配置与凭证自检(站点可达 → 密码有效 → 角色提示) | 否 |
site_overview |
站点概况:名称、地址、账号角色、各类内容总量 | 否 |
post_list |
列文章:状态/关键词/分类/标签/作者过滤 | 否 |
post_get |
读单篇全文(rendered 或 raw 编辑原文) | 否 |
post_create |
新建文章:默认草稿,可定时发布(status=future + date) | 是 |
post_update |
更新文章:只改传入的字段 | 是 |
post_delete |
删除文章:默认回收站,force=true 才永久删除 |
是 |
media_upload |
上传本机文件到媒体库(≤64MB) | 是 |
media_list |
列媒体库 | 否 |
comment_list |
列评论:按文章/状态过滤 | 否 |
comment_moderate |
评论管理:通过/待审/垃圾/回收站/永久删除 | 是 |
comment_reply |
以连接账号身份回复评论(支持楼中楼) | 是 |
term_list |
列分类/标签(含文章数) | 否 |
四、安全与数据边界
- 只连你自己填的站点:内置护栏校验目标域名必须与连接配置一致,路径必须在 WordPress 官方 REST API(
/wp-json/)命名空间内,其余一律拒绝(含云元数据地址)。 - 凭证仅保存在本机:应用密码走平台「自填 Token」注入环境变量,不落盘、不进连接器文件、不回传任何第三方;日志自动脱敏。
- 删除有缓冲:文章/评论删除默认进回收站;永久删除需要显式
force=true/delete。 - 速率温和:全局 2 QPS 限频,不会压垮你的站点。
五、常见问题
| 现象 | 原因与处理 |
|---|---|
| 401 / 凭证校验失败 | 应用密码复制时带了换行、用户名填成昵称、或密码已被撤销——重新生成再填 |
| 403 权限不足 | 账号角色不够:发文需「作者」+,评论管理需「编辑」+ |
| 看不到应用密码功能 | 站点不是 https(localhost 除外)或安全插件隐藏了它 |
| 连不上 / 超时 | 确认本机能访问站点;某些主机会拦截境外请求或限制 REST API |
rest_cannot_read 读不了草稿 |
正常:草稿只有有权限的账号可见,确认用的是作者以上角色的应用密码 |
Metadata
Release files for wb-wordpress-site-manager-mcp 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| wb_wordpress_site_manager_mcp-1.0.0.tar.gz | 21.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| wb_wordpress_site_manager_mcp-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 44.8 kB
Release files / wb_wordpress_site_manager_mcp-1.0.0.tar.gz
| Download URL | wb_wordpress_site_manager_mcp-1.0.0.tar.gz |
|---|---|
| Size | 21.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f27e00107a58ec33bcafd0dcb14d6110fef9fdeff932a050463c4b59b27e2126
|
|
BLAKE2b-256 checksum How to use checksums |
125764393a3074d0b8f84c523aaa0d5ff8cdd9fb4750149ca64abb7d42b13210
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Release files / wb_wordpress_site_manager_mcp-1.0.0-py3-none-any.whl
| Download URL | wb_wordpress_site_manager_mcp-1.0.0-py3-none-any.whl |
|---|---|
| Size | 22.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
614e88f5cbc21f7d73921afda9929f8013df0e05c8ad9c0bdeb8be5e7e2d5b88
|
|
BLAKE2b-256 checksum How to use checksums |
cc4b705025be5f0bf7dce35ee62b6bcada8cf58f3202c66bf935bfd5175ea212
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Security for wb-wordpress-site-manager-mcp 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.