Ghost CMS管理服务器

一个通过LLM接口(如Claude)与Ghost CMS交互的Model Context Protocol(MCP)服务器,提供安全的JWT认证和丰富的MCP工具集,用于管理文章、用户、会员、订阅等级、优惠和新闻简报。

  • by MFYDev
  • TypeScript
  • 本地部署
  • 239 星标
  • 更新于
在 GitHub 查看 MFYDev/ghost-mcp

使用说明

Ghost MCP服务器

一个模型上下文协议(MCP)服务器,用于通过Claude等LLM接口与Ghost CMS交互。此服务器提供对Ghost博客的安全和全面的访问,利用JWT身份验证和一套丰富的MCP工具来管理帖子、用户、成员、层级、优惠和新闻通讯。

特性

  • 使用安全Ghost Admin API请求 @tryghost/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服务器获得:

  • 帖子:在Ghost网站上发布的文章和内容。
  • 成员:您网站的注册用户和订阅者。
  • 通讯:通过Ghost管理和发送的电子邮件通讯。
  • 优惠:会员促销优惠和折扣。
  • 邀请:邀请新用户或员工加入您的Ghost网站。
  • 角色:Ghost管理员中的用户角色和权限。
  • 标签:帖子和内容的组织标签。
  • 层级:会员的订阅等级和计划。
  • 用户:管理员用户和员工帐户。
  • 网络钩子:自动向外部服务发送事件通知。

可用工具

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

帖子

  • 浏览帖子:列出带有可选过滤器、分页和排序的帖子。
  • 阅读文章:通过ID或slug检索帖子。
  • 添加帖子:创建一个包含标题、内容和状态的新帖子。
  • 编辑帖子:按ID更新现有帖子。
  • 删除帖子:按ID删除帖子。

成员

  • 成员浏览:使用筛选器和分页列出成员。
  • 阅读会员:通过ID或电子邮件检索成员。
  • 添加成员:创建新成员。
  • 编辑成员:更新成员详细信息。
  • 删除成员:删除成员。

通讯

  • 浏览通讯:列出时事通讯。
  • 阅读时事通讯:按ID检索时事通讯。
  • 添加新闻稿:创建新的时事通讯。
  • 编辑时事通讯:更新通讯详细信息。
  • 删除通讯:删除时事通讯。

优惠

  • 浏览优惠:列出报价。
  • 阅读优惠:按ID检索报价。
  • 添加优惠:创建新报价。
  • 编辑优惠:更新报价详细信息。
  • 删除报价:删除报价。

邀请

  • 浏览邀请:列表邀请。
  • 添加邀请:创建新邀请。
  • 删除邀请:删除邀请。

角色

  • 浏览角色:列出角色。
  • 阅读角色:按ID检索角色。

标签

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

层级

  • 浏览层级:列出层级。
  • 读取层:按ID检索层。
  • 添加层:创建新层。
  • 编辑层级:更新层详细信息。
  • 删除层:删除一个层。

用户

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

网络钩子

  • 浏览Webhooks:列出webhooks。
  • 添加Webhook:创建新的webhook。
  • 删除Webhook:删除webhook。

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

错误处理

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

贡献

  1. Fork存储库
  2. 创建特征分支
  3. 提交更改
  4. 创建拉取请求

许可证

麻省理工学院