MCP服务

🚀 为什么选择本站 MCP 服务？（亮点）

• AI 直接发稿：Claude / Cursor / ChatGPT 等支持 MCP 的客户端，可直接调用本站发布、更新、删除文章，无需手动复制粘贴。
• 权限可控：后台可一键关闭 MCP、限制每日/每小时发布条数、强制待审、IP 白名单、敏感词过滤。
• 全程审计：每次调用写入日志表，后台可查最近 50 条与 14 天统计，异常可追溯。
• 标题自动标记：MCP 发布的文章标题自动追加 [mcp]，一眼区分 AI 内容与人工内容。
• 双认证：支持 WordPress 应用密码（Basic Auth）与本站 Token（Bearer），灵活切换。
• 媒体上传：支持 base64 上传图片/文件，自动入库媒体库并返回 URL，可直接插入文章。

一、准备工作（新手必读）

1. 注册/登录本站账号，确保账号有「编辑文章」权限（作者及以上）。
2. 进入「用户 → 个人资料」，滚动到「应用密码」区域，输入名称（如 mcp-client），点击「添加新应用密码」，复制生成的 24 位密码（只显示一次）。
3. （可选）访问「MCP Token」页面生成本站 Token，用于 Bearer 认证。

二、MCP 端点地址

内网：http://192.168.68.19:9091/wp-json/mcp-publisher/v1/endpoint
公网：https://www.88531.cn/wp-json/mcp-publisher/v1/endpoint

三、在客户端配置 MCP

以 Claude Desktop 为例，编辑配置文件：

{
  "mcpServers": {
    "88531": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.88531.cn/wp-json/mcp-publisher/v1/endpoint"],
      "env": {
        "MCP_REMOTE_HEADERS": "Authorization: Basic base64(用户名:应用密码)"
      }
    }
  }
}

或直接用 curl 测试。

四、逐步测试（每个步骤都要做）

步骤 1：initialize

curl -u "用户名:应用密码" -X POST https://www.88531.cn/wp-json/mcp-publisher/v1/endpoint 
 -H "Content-Type: application/json" 
 -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

预期返回 protocolVersion 与 serverInfo。

步骤 2：列出工具

curl -u "用户名:应用密码" -X POST https://www.88531.cn/wp-json/mcp-publisher/v1/endpoint 
 -H "Content-Type: application/json" 
 -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

应看到 publish_post、delete_post、list_posts、get_post、list_categories、list_tags、create_category、upload_media。

步骤 3：查询分类

curl -u "用户名:应用密码" -X POST https://www.88531.cn/wp-json/mcp-publisher/v1/endpoint 
 -H "Content-Type: application/json" 
 -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_categories","arguments":{}}}'

步骤 4：发布一篇草稿

curl -u "用户名:应用密码" -X POST https://www.88531.cn/wp-json/mcp-publisher/v1/endpoint 
 -H "Content-Type: application/json" 
 -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"publish_post","arguments":{"title":"MCP 测试文章","content":"
Hello MCP
","status":"draft"}}}'

返回 Post #ID (draft)，后台文章标题会显示「MCP 测试文章 [mcp]」。

步骤 5：上传图片

curl -u "用户名:应用密码" -X POST https://www.88531.cn/wp-json/mcp-publisher/v1/endpoint 
 -H "Content-Type: application/json" 
 -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"upload_media","arguments":{"filename":"demo.jpg","mime":"image/jpeg","data_base64":"BASE64...","title":"demo"}}}'

返回 attachment id 与 url，可在 publish_post 的 featured_media 字段使用。

五、后台设置说明

进入「设置 → MCP 发布」：

• MCP 总开关：关闭后所有请求返回 403。
• 每日/每小时最大发布数：0 表示不限制；超限返回 Daily/Hourly limit reached。
• 标题标记：默认 [mcp]，可自定义或留空。
• 允许草稿发布：关闭时 draft 会被强制为 publish。
• 新文章强制 pending 审核：开启后所有发布先进入待审。
• 敏感词：每行一个，命中即拒绝。
• IP 白名单：每行一个 IP，空表示不限制。
• 日志保留天数：默认 30，每日 cron 自动清理。

页面下方显示今日用量、14 天统计与最近 50 条日志。

六、常见问题

• 401 Unauthorized：应用密码错误或未生成；确认账号有 edit_posts 权限。
• 403 MCP disabled：后台总开关关闭。
• Daily/Hourly limit reached：配额用完，次日/下小时重置。
• Sensitive word detected：内容命中敏感词。
• IP not allowed：当前 IP 不在白名单。
• Token 无效：Token 已撤销或用户无 edit_posts 权限。

七、安全建议

• 应用密码与 Token 仅在可信环境使用，泄露后立即删除重建。
• 生产环境建议开启 IP 白名单、敏感词过滤与 auto_pending。
• 定期查看日志，发现异常及时撤销 Token。