Ghost MCP (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. 创建拉取请求

许可证

麻省理工学院