Ghost MCP 服务器

‼️ 重要通知：从 Python 迁移到 TypeScript

在 v0.1.0 版本中，我已将 Ghost MCP 服务器完全从 Python 重写为 TypeScript。这一重大变更带来了以下好处：

• 简化的安装：现在作为 NPM 包 (@fanyangmeng/ghost-mcp) 提供
• 提高了可靠性：使用官方的 @tryghost/admin-api 客户端而非自定义实现
• 更好的可维护性：TypeScript 提供类型安全和更好的代码组织
• 简化的配置：简单的环境变量设置

不兼容的更改

• 不再需要 Python 依赖
• 配置方法已更改（现在使用 Node.js 环境变量）
• Docker 部署已简化
• 安装过程不同（现在使用 NPM）

请参阅下面更新的文档以获取从 Python 版本迁移的详细信息。如果您遇到任何问题，请随时在 GitHub 上提交问题。

一个用于通过 LLM 接口（如 Claude）与 Ghost CMS 交互的模型上下文协议 (MCP) 服务器。该服务器提供了安全且全面的访问您的 Ghost 博客的功能，利用 JWT 身份验证和丰富的 MCP 工具集来管理文章、用户、成员、层级、优惠和通讯。

功能

• 使用 @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 服务器通过模型上下文协议提供了全面的工具集，用于管理您的 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 服务器使用自定义的 GhostError 异常来处理 API 通信错误和处理问题。这确保了清晰且描述性的错误消息，以帮助故障排除。

贡献

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

许可证

MIT