Ghost MCP Server

一个用于通过 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"
        }
      }
    }
}

可用资源

以下 Ghost CMS 资源可通过此 MCP 服务器访问：

• Posts：在您的 Ghost 站点上发布的文章和内容。

• Pages：独立页面（关于、落地页、支柱页面）——与文章具有相同字段，包括所有 SEO/社交元数据。

• Members：您站点的注册用户和订阅者。

• Newsletters：通过 Ghost 管理和发送的电子邮件通讯。

• Offers：面向会员的促销优惠和折扣。

• Invites：邀请新用户或员工加入您的 Ghost 站点。

• Roles：Ghost 管理后台中的用户角色和权限。

• Tags：用于文章和内容的组织标签。

• Tiers：面向会员的订阅层级和方案。

• Users：管理员用户和员工账户。

• Webhooks：向外部服务发送的自动化事件通知。

可用工具

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

Posts

• Browse Posts：使用可选过滤器、分页和排序列出文章。

• Read Post：按 ID 或 slug 检索文章。

• Add Post：使用标题、内容和状态创建新文章。

• Edit Post：按 ID 更新现有文章。

• Delete Post：按 ID 删除文章。

Pages

• Browse Pages：使用可选过滤器、分页和排序列出页面。

• Read Page：按 ID 或 slug 检索单个页面。

• Add Page：创建新页面。

• Edit Page：更新页面。省略 html/lexical 将保持内容不变，这使得仅元数据的编辑是安全的。

• Delete Page：删除页面。

可编辑字段包括 slug、status、visibility、featured、published_at、 custom_excerpt、feature_image（+ _alt、_caption）、show_title_and_feature_image、 meta_title、meta_description、og_title、og_description、og_image、 twitter_title、twitter_description、twitter_image、codeinjection_head、 codeinjection_foot、canonical_url、tags 和 authors。

Members

• Browse Members：使用过滤器和分页列出会员。

• Read Member：按 ID 或电子邮件检索会员。

• Add Member：创建新会员。

• Edit Member：更新会员详细信息。

• Delete Member：删除会员。

Newsletters

• Browse Newsletters：列出新闻通讯。

• Read Newsletter：按 ID 检索新闻通讯。

• Add Newsletter：创建新的新闻通讯。

• Edit Newsletter：更新新闻通讯详细信息。

• Delete Newsletter：删除新闻通讯。

Offers

• Browse Offers：列出优惠。

• Read Offer：按 ID 检索优惠。

• Add Offer：创建新优惠。

• Edit Offer：更新优惠详细信息。

• Delete Offer：删除优惠。

Invites

• Browse Invites：列出邀请。

• Add Invite：创建新邀请。

• Delete Invite：删除邀请。

Roles

• Browse Roles：列出角色。

• Read Role：按 ID 检索角色。

Tags

• Browse Tags：列出标签。

• Read Tag：按 ID 或 slug 检索标签。

• Add Tag：创建新标签。

• Edit Tag：更新标签详细信息。

• Delete Tag：删除标签。

Tiers

• Browse Tiers：列出层级。

• Read Tier：按 ID 检索层级。

• Add Tier：创建新层级。

• Edit Tier：更新层级详细信息。

• Delete Tier：删除层级。

Users

• Browse Users：列出用户。

• Read User：按 ID 或 slug 检索用户。

• Edit User：更新用户详细信息。

• Delete User：删除用户。

Webhooks

• Browse Webhooks：列出 Webhooks。

• Add Webhook：创建新 Webhook。

• Delete Webhook：删除 Webhook。

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

错误处理

Ghost MCP Server 使用自定义的 GhostError 异常来处理 API 通信错误和处理问题。这确保了清晰、描述性的错误消息，有助于故障排查。

贡献

1. Fork 仓库

2. 创建功能分支

3. 提交更改

4. 创建拉取请求

许可证

MIT