Ghost CMS 配置 MCP Server 指南

概述

Ghost MCP Server 是社区开发者基于 Ghost Admin API 实现的 Model Context Protocol 封装,让 Claude 等 AI 助手可以通过对话直接管理 Ghost 博客的文章、标签、页面、会员等内容。

Ghost 本身不支持 MCP,MCP 是社区开发者在 Ghost API 基础上额外实现的。两者的关系:

Claude / AI 助手
      ↓ MCP 协议
  Ghost MCP Server   ← 社区开发(@fanyangmeng/ghost-mcp)
      ↓ REST API 调用
   Ghost Admin API   ← Ghost 官方提供
      ↓
   Ghost 博客系统

前置条件

  • 已部署并运行的 Ghost 博客实例
  • 本地已安装 Node.js(用于运行 npx)
  • Claude Code 或其他支持 MCP 的 AI 客户端

第一步:创建 Ghost Admin API Key

  1. 登录 Ghost 管理后台(/ghost
  2. 进入 Settings → Integrations
  3. 点击 Add custom integration
  4. 输入名称(如 MCP Server),点击创建
  5. 复制生成的 Admin API Key(格式为 id:secret
注意: 通过管理后台创建的 Integration 会自动分配 Admin Integration 角色,拥有完整的 API 权限。

第二步:配置 MCP

在项目根目录的 .mcp.json 中添加以下配置:

{
  "mcpServers": {
    "ghost-mcp": {
      "command": "npx",
      "args": ["-y", "@fanyangmeng/ghost-mcp"],
      "env": {
        "GHOST_API_URL": "https://your-ghost-blog.com",
        "GHOST_ADMIN_API_KEY": "your_id:your_secret",
        "GHOST_API_VERSION": "v5.0"
      }
    }
  }
}

配置说明

环境变量说明
GHOST_API_URLGhost 博客的访问地址
GHOST_ADMIN_API_KEY上一步获取的 Admin API Key(id:secret 格式)
GHOST_API_VERSIONAPI 版本,填 v5.0

第三步:重启 Claude Code

配置完成后,重启 Claude Code 会话,ghost-mcp 工具会自动加载。之后你可以通过自然语言对话操作博客。

可用功能

Ghost MCP Server 提供以下十类资源的管理能力:

分类功能操作
内容管理文章(Posts)创建、读取、编辑、删除、列表
内容管理标签(Tags)创建、读取、编辑、删除、列表
用户管理会员(Members)创建、读取、编辑、删除、列表
用户管理用户(Users)读取、编辑、删除、列表
用户管理邀请(Invites)创建、删除、列表
用户管理角色(Roles)读取、列表
订阅等级(Tiers)创建、读取、编辑、删除、列表
订阅优惠(Offers)创建、读取、编辑、删除、列表
通讯Newsletter创建、读取、编辑、删除、列表
集成Webhooks创建、编辑、删除

使用示例

配置完成后,你可以在 Claude Code 中直接用自然语言操作博客:

  • "帮我创建一篇关于 Docker 部署的文章"
  • "列出所有草稿文章"
  • "给这篇文章添加 DevOps 标签"
  • "查看当前所有会员"

参考资源