Ghost MCP 服务器

一个用于通过 Claude 等 LLM 接口与 Ghost CMS 进行交互的模型上下文协议 (MCP) 服务器。该服务器通过 JWT 身份验证和一套丰富的 MCP 工具，为您的 Ghost 博客提供安全且全面的访问权限，用于管理文章、用户、会员、层级、优惠和新闻通讯。

demo

功能特性

使用 @tryghost/admin-api 进行安全的 Ghost Admin API 请求
全面的实体访问权限，包括文章、用户、会员、层级、优惠和新闻通讯
具备模糊匹配和精确匹配选项的高级搜索功能
为 Ghost 实体提供详细、易读的输出
使用自定义 GhostError 异常进行稳健的错误处理
通过 MCP 上下文集成日志支持，以增强故障排除能力

Related MCP server: Ghost MCP Server

使用方法

若要将其与 MCP 客户端（例如 Claude Desktop）配合使用，请将以下内容添加到您的 claude_desktop_config.json 中：

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

可用资源

通过此 MCP 服务器可以使用以下 Ghost CMS 资源：

文章 (Posts)：在您的 Ghost 网站上发布的文章和内容。
会员 (Members)：您网站的注册用户和订阅者。
新闻通讯 (Newsletters)：通过 Ghost 管理和发送的电子邮件新闻通讯。
优惠 (Offers)：为会员提供的促销优惠和折扣。
邀请 (Invites)：邀请新用户或员工加入您的 Ghost 网站。
角色 (Roles)：Ghost 管理后台中的用户角色和权限。
标签 (Tags)：用于文章和内容的组织标签。
层级 (Tiers)：会员的订阅层级和计划。
用户 (Users)：管理员用户和员工账户。
Webhook：发送给外部服务的自动化事件通知。

可用工具

此 MCP 服务器公开了一套全面的工具，用于通过模型上下文协议管理您的 Ghost CMS。每个资源都提供了一组操作，通常包括浏览、读取、创建、编辑和删除实体。以下是可用工具的摘要：

文章 (Posts)

浏览文章：列出文章，支持可选的过滤、分页和排序。
读取文章：通过 ID 或别名检索文章。
添加文章：创建带有标题、内容和状态的新文章。
编辑文章：通过 ID 更新现有文章。
删除文章：通过 ID 删除文章。

会员 (Members)

浏览会员：列出会员，支持过滤和分页。
读取会员：通过 ID 或电子邮件检索会员。
添加会员：创建新会员。
编辑会员：更新会员详细信息。
删除会员：删除会员。

新闻通讯 (Newsletters)

浏览新闻通讯：列出新闻通讯。
读取新闻通讯：通过 ID 检索新闻通讯。
添加新闻通讯：创建新新闻通讯。
编辑新闻通讯：更新新闻通讯详细信息。
删除新闻通讯：删除新闻通讯。

优惠 (Offers)

浏览优惠：列出优惠。
读取优惠：通过 ID 检索优惠。
添加优惠：创建新优惠。
编辑优惠：更新优惠详细信息。
删除优惠：删除优惠。

邀请 (Invites)

浏览邀请：列出邀请。
添加邀请：创建新邀请。
删除邀请：删除邀请。

角色 (Roles)

浏览角色：列出角色。
读取角色：通过 ID 检索角色。

标签 (Tags)

浏览标签：列出标签。
读取标签：通过 ID 或别名检索标签。
添加标签：创建新标签。
编辑标签：更新标签详细信息。
删除标签：删除标签。

层级 (Tiers)

浏览层级：列出层级。
读取层级：通过 ID 检索层级。
添加层级：创建新层级。
编辑层级：更新层级详细信息。
删除层级：删除层级。

用户 (Users)

浏览用户：列出用户。
读取用户：通过 ID 或别名检索用户。
编辑用户：更新用户详细信息。
删除用户：删除用户。

Webhook

浏览 Webhook：列出 Webhook。
添加 Webhook：创建新 Webhook。
删除 Webhook：删除 Webhook。

每个工具都可以通过 MCP 协议访问，并可从兼容的客户端调用。有关详细的参数模式和用法，请参阅 src/tools/ 中的源代码。

错误处理

Ghost MCP 服务器采用自定义的 GhostError 异常来处理 API 通信错误和处理问题。这确保了清晰且具有描述性的错误消息，以协助进行故障排除。

贡献

Fork 仓库
创建功能分支
提交更改
创建拉取请求 (Pull Request)

许可证

MIT

Ghost MCP Server