Skip to main content

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 分钟)

  1. 登录你的 WordPress 后台(https://你的站点/wp-admin)。
  2. 打开 用户 → 个人资料,拉到 应用密码 区域;在名称框输入 WorkBuddy,点 添加新应用密码。
  3. 复制生成的密码(形如 xxxx xxxx xxxx xxxx xxxx xxxx,只显示一次)。
  4. 回到 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)

Source distribution for wb-wordpress-site-manager-mcp 1.0.0
File Size Uploaded Provenance
wb_wordpress_site_manager_mcp-1.0.0.tar.gz 21.8 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for wb-wordpress-site-manager-mcp 1.0.0
File Interpreter ABI Platform
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.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page