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
- 登录 Ghost 管理后台(
/ghost) - 进入 Settings → Integrations
- 点击 Add custom integration
- 输入名称(如
MCP Server),点击创建 - 复制生成的 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_URL | Ghost 博客的访问地址 |
GHOST_ADMIN_API_KEY | 上一步获取的 Admin API Key(id:secret 格式) |
GHOST_API_VERSION | API 版本,填 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 标签"
- "查看当前所有会员"