使用说明
wp-publisher-mcp
用 Claude Code 直接把 Markdown 發布到 WordPress，支援 Gutenberg 區塊。
由 Shiuan 開發。
功能
- ✅ Markdown → WordPress 草稿 / 正式發文
- ✅ 自動轉換 Gutenberg 區塊（
>Quote、>>Pullquote） - ✅ 自動建立分類、標籤（不存在則新增）
- ✅ 讀取 frontmatter（標題、分類、標籤、摘要）
- ✅ 發布後自動把
wp_id寫回.md檔，下次執行自動「更新」而非重複新增
安裝
第一步：取得 WordPress Application Password
- 登入 WordPress 後台 → 使用者 → 個人資料
- 往下捲到「應用程式密碼」
- 名稱輸入
Claude Code，點「新增應用程式密碼」 - 複製產生的密碼（格式：
xxxx xxxx xxxx xxxx xxxx xxxx）
第二步：在 Claude Code 安裝 MCP
claude mcp add wordpress \
--command uvx \
--args "wp-publisher-mcp" \
--env WP_URL=https://yoursite.com \
--env WP_USER=yourusername \
--env WP_APP_PASSWORD="xxxx xxxx xxxx xxxx"
就這樣。重啟 Claude Code，MCP 即生效。
Markdown 檔案格式
---
title: "文章標題"
categories: [AI寫作, 工具]
tags: [Claude, WordPress]
status: draft
excerpt: "150 字以內的文章摘要"
---
## H2 段落標題
正文內容，**粗體**，*斜體*，[超連結](https://url)
> 這是引用區塊（Gutenberg Quote block）
>> 這是重點金句（Gutenberg Pullquote block）
- 清單項目
在 Claude 裡使用
安裝後，直接跟 Claude 說：
幫我發布 blog/20260308-ai-writing.md 到 WordPress（草稿）
或：
把 blog/20260308-ai-writing.md 直接發布（不要草稿）
Claude 會呼叫 publish_wordpress_post 工具，完成後回傳草稿編輯連結。
工具說明
publish_wordpress_post
| 參數 | 類型 | 說明 |
|---|---|---|
filepath |
string | Markdown 檔案路徑 |
publish |
bool | true = 直接發布，false = 草稿（預設） |
get_wordpress_post_status
| 參數 | 類型 | 說明 |
|---|---|---|
wp_id |
int | WordPress 文章 ID |
環境變數
| 變數 | 說明 |
|---|---|
WP_URL |
WordPress 網站網址（例：https://yoursite.com） |
WP_USER |
WordPress 使用者名稱 |
WP_APP_PASSWORD |
Application Password |
作者
由 Shiuan 開發。
我是一個寫作者，用 Claude Code 建立了一套從寫作到發布的完整流程。這個工具是其中一個環節的開源版本。
- 🌐 官網：freeshiuan.com
- 📬 電子報：freeshiuan.com（訂閱「自由宣言」，每週一封關於 AI 寫作與自由工作的信）
支持這個專案
這個工具完全免費、開源。
如果它幫到你了，最好的回報方式是：
訂閱我的電子報 — 我在裡面分享 AI 寫作流程、工具組合、以及用 Claude Code 做出這類東西的幕後細節。 👉 freeshiuan.com
或者請我喝杯咖啡： ☕ buymeacoffee.com/freeshiuan
授權
MIT
