👻 Ghost CMS 管理与新闻通讯 MCP 服务器

一个生产就绪的 Model Context Protocol (MCP) 服务器，支持 Streamable HTTP（MCP 规范）、SSE 和 stdio，允许 AI 模型（Claude、Cursor、Antigravity、ChatGPT、Cline、Zed 等）管理、策划、起草、发布和管理自托管的 Ghost CMS 博客与新闻通讯。

专为在您的 VPS 上独立部署而设计，与您的 Ghost 实例并排运行，可部署在 Docker、Coolify、Caddy 或 Nginx 之后。

⚡ Streamable HTTP 端点

Related MCP server: Ghost CMS MCP Server

🛠️ 内置 MCP 工具目录

📝 1. 文章与新闻通讯

• ghost_list_posts：搜索、筛选和分页浏览博客文章与新闻通讯期刊（draft、published、scheduled、sent、all）。

• ghost_get_post：获取完整内容、HTML、mobiledoc/lexical、标签、作者以及邮件点击/送达统计。

• ghost_create_post：直接从 Markdown 或 HTML 创建博客文章和新闻通讯，支持 SEO 元数据、标签、作者、摘要和自定义排期。

• ghost_update_post：编辑现有文章，自动进行并发同步（updated_at）。

• ghost_delete_post：按 ID 永久删除文章。

• ghost_publish_and_send_newsletter：一键发布并群发邮件至订阅层级（all、status:free、status:paid）。

📄 2. 静态页面

• ghost_list_pages、ghost_get_page、ghost_create_page、ghost_update_page、ghost_delete_page：完整的静态页面生命周期管理（关于我们、联系我们、落地页）。

💌 3. 新闻通讯与邮件配置

• ghost_list_newsletters：列出所有出版物邮件新闻通讯，包含订阅者数量和发送历史。

• ghost_get_newsletter、ghost_create_newsletter、ghost_update_newsletter：管理发件人名称、发件人邮箱、回复地址和订阅者默认设置。

👥 4. 会员与订阅者

• ghost_list_members：按邮箱、姓名、订阅层级和标签搜索和筛选订阅者。

• ghost_get_member、ghost_create_member、ghost_update_member、ghost_delete_member：订阅者资料管理和免费层级分配。

• ghost_add_member_labels：为会员追加细分标签。

🏷️ 5. 标签、层级、设置、媒体与 Webhooks

• 标签：ghost_list_tags、ghost_get_tag、ghost_create_tag、ghost_update_tag、ghost_delete_tag（包括内部 #tags）。

• 层级与优惠：ghost_list_tiers、ghost_list_offers（免费与付费会员、定价、优惠券）。

• 站点设置与诊断：ghost_get_site_info、ghost_test_connection。

• 媒体上传：ghost_upload_image（将本地文件、网页 URL 或 base64 图片上传到 Ghost 作为特色图片）。

• Webhooks：ghost_list_webhooks、ghost_create_webhook、ghost_delete_webhook。

📦 MCP 资源与提示词

资源

• ghost://site/info – 出版物标题、URL、版本和全局配置。

• ghost://newsletters – 活跃的邮件新闻通讯及其订阅者数量。

• ghost://tiers – 可用的会员层级和定价模式。

• ghost://posts/recent – 最近发布的 10 篇文章。

• ghost://members/summary – 会员数量和近期订阅者活动。

提示词

• draft-blog-post – 引导式交互模板，用于创建带有标签、摘要和格式化的 SEO 优化博客文章。

• draft-newsletter – 构建并撰写一封可直接群发的引人入胜的邮件新闻通讯期刊。

• ghost-content-audit – 对近期文章、标签规范性和受众增长建议进行完整的编辑审查。

🔑 Ghost Admin API 设置

1. 打开您的 Ghost Admin 仪表盘（https://your-blog.ghost.io/ghost 或 http://localhost:2368/ghost）。

2. 前往 设置（齿轮图标） ➔ 集成。

3. 点击 添加自定义集成。

4. 为其命名（例如 AI Admin Assistant 或 MCP Server）。

5. 复制：

   • Admin API URL（例如 http://localhost:2368 或 https://blog.yourdomain.com）

   • Admin API Key（例如 64a7c8e2b0123456789abcde:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef）

🚀 在 Coolify 与 VPS 上部署，与 Ghost 并排运行

在 Coolify 上部署（零配置反向代理与 SSL）

Coolify 自动处理 Traefik 反向代理、Let's Encrypt SSL 证书、Docker 网络和零停机部署。

1. 在 Coolify 中从您的 Git 仓库 创建新资源。

2. 将 Base Directory 设置为 /ghost-admin-mcp（如果是独立仓库则设为根目录）。

3. 将 Build Pack 设置为 Dockerfile，Port 设置为 8765。

4. 配置环境变量：

   • GHOST_ADMIN_API_URL：https://blog.yourdomain.com

   • GHOST_ADMIN_API_KEY：<your-admin-api-key>

   • MCP_AUTH_TOKEN：<your-random-token>

   • PORT：8765

   • TRANSPORT：streamable-http

5. 将 健康检查路径 设置为 /health。

6. 设置您的域名（例如 https://mcp.yourdomain.com）— Coolify 会自动处理 SSL！

如需在 Coolify 中使用多容器 Docker Compose，请参阅 COOLIFY.md。

🔌 连接远程 AI 客户端

Streamable HTTP（MCP 远程客户端 / Cursor / Claude）

配置您的远程客户端以连接到：

• URL：https://mcp.yourdomain.com/mcp

• Headers：

{
  "Authorization": "Bearer your_custom_secret_bearer_token"
}

本地 Stdio（Claude Desktop / Cursor 本地回退）

{
  "mcpServers": {
    "ghost-admin": {
      "command": "node",
      "args": ["/path/to/ghost-admin-mcp/dist/index.js"],
      "env": {
        "GHOST_ADMIN_API_URL": "https://blog.yourdomain.com",
        "GHOST_ADMIN_API_KEY": "your_key_id:your_secret_key"
      }
    }
  }
}

🧪 测试

bun test

📄 许可证

MIT