Ghost MCP Server

Ghost MCP 服务

一个用于通过 Claude 等 LLM 接口与 Ghost CMS 交互的 Model Context Protocol（MCP）服务。该服务通过 JWT 身份验证，并借助丰富的 MCP 工具，安全、全面地访问你的 Ghost 博客，以管理文章、用户、成员、订阅层级、优惠和新闻通讯。

功能

• 使用 @tryghost/admin-api 安全地发送 Ghost Admin API 请求
• 全面访问各类实体，包括文章、用户、成员、订阅层级、优惠和新闻通讯
• 提供高级搜索功能，支持模糊匹配和精确匹配
• 以清晰易读的方式详细输出 Ghost 实体信息
• 使用自定义 GhostError 异常进行可靠的错误处理
• 通过 MCP 上下文集成日志记录，便于排查问题

用法

要通过 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 资源：

• 文章：发布在你的 Ghost 站点上的文章和内容。
• 成员：在你的站点注册的用户和订阅者。
• 新闻通讯：通过 Ghost 管理和发送的电子邮件新闻通讯。
• 优惠：面向成员的促销优惠和折扣。
• 邀请：邀请新用户或员工加入你的 Ghost 站点。
• 角色：Ghost 管理后台中的用户角色和权限。
• 标签：用于整理文章和内容的标签。
• 订阅层级：面向成员的订阅层级和方案。
• 用户：管理员用户和员工账户。
• Webhook：向外部服务发送的自动事件通知。

可用工具

此 MCP 服务通过 Model Context Protocol 提供一系列全面的工具，用于管理 Ghost CMS。每类资源都提供一组操作，通常包括浏览、读取、创建、编辑和删除实体。以下是可用工具的摘要：

文章

• 浏览文章：列出文章，支持可选筛选条件、分页和排序。
• 读取文章：通过 ID 或 slug 获取文章。
• 添加文章：创建包含标题、内容和状态的新文章。
• 编辑文章：通过 ID 更新现有文章。
• 删除文章：通过 ID 删除文章。

成员

• 浏览成员：列出成员，支持筛选条件和分页。
• 读取成员：通过 ID 或电子邮件地址获取成员。
• 添加成员：创建新成员。
• 编辑成员：更新成员详情。
• 删除成员：移除成员。

新闻通讯

• 浏览新闻通讯：列出新闻通讯。
• 读取新闻通讯：通过 ID 获取新闻通讯。
• 添加新闻通讯：创建新的新闻通讯。
• 编辑新闻通讯：更新新闻通讯详情。
• 删除新闻通讯：移除新闻通讯。

优惠

• 浏览优惠：列出优惠。
• 读取优惠：通过 ID 获取优惠。
• 添加优惠：创建新优惠。
• 编辑优惠：更新优惠详情。
• 删除优惠：移除优惠。

邀请

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

角色

• 浏览角色：列出角色。
• 读取角色：通过 ID 获取角色。

标签

• 浏览标签：列出标签。
• 读取标签：通过 ID 或 slug 获取标签。
• 添加标签：创建新标签。
• 编辑标签：更新标签详情。
• 删除标签：移除标签。

订阅层级

• 浏览订阅层级：列出订阅层级。
• 读取订阅层级：通过 ID 获取订阅层级。
• 添加订阅层级：创建新的订阅层级。
• 编辑订阅层级：更新订阅层级详情。
• 删除订阅层级：移除订阅层级。

用户

• 浏览用户：列出用户。
• 读取用户：通过 ID 或 slug 获取用户。
• 编辑用户：更新用户详情。
• 删除用户：移除用户。

Webhooks

• 浏览 Webhooks：列出 Webhooks。
• 添加 Webhook：创建新的 Webhook。
• 删除 Webhook：移除 Webhook。

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

错误处理

Ghost MCP Server 使用自定义的 GhostError 异常来处理 API 通信错误和处理问题。这有助于提供清晰、明确的错误消息，便于排查问题。

参与贡献

1. Fork 仓库
2. 创建功能分支
3. 提交更改
4. 创建拉取请求

许可证

MIT