Ghost MCP 服务器

!! 重要通知: Python 到 TypeScript 迁移

我完全改写了Ghost MCP服务器 从Python到TypeScript 在这个v0.1.0发行. 这一重大变化带来若干好处:

• 简化安装:现在作为国家防范机制软件包提供 (@fanyangmeng/ghost-mcp)
• 提高可靠性: 使用官方的 @ tryghost/admin- api 客户端而不是自定义执行
• 更好的可维护性:TypeScript提供类型安全和更好的代码组织
• 精简配置:简单环境变量设置

中断更改

• Python 依赖性不再需要
• 配置方法已改变( 现在使用 Node.js 环境变量)
• Docker 部署已简化
• 不同的安装程序(现在使用国家预防机制)

关于从Python版本迁移的详细情况,请参见以下最新文件。 如果您遇到任何问题,请随意在GitHub上打开一个问题.

一个模型背景协议(MCP)服务器,用于通过克洛德等LLM接口与Ghost CMS互动. 利用JWT认证以及一套丰富的MCP工具来管理帖子、用户、成员、等级、提议和通讯.

特征

• 使用 Ghost 管理员 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 管理员内部的用户角色和权限.
• 标记: 员额和内容的组织标签.
• 等级: 成员订阅级别和计划.
• 用户: 管理用户和工作人员账户.
• 网络呼号: 对外服务的自动事件通知.

可用工具

这个MCP服务器通过"模型上下文协议"暴露出一套管理您Ghost CMS的综合性工具. 每个资源提供一组操作,一般包括浏览,阅读,创建,编辑,删除实体. 以下是现有工具的摘要:

员额

• 浏览点: 列出带有可选过滤器、页码和顺序的帖子.
• 读取邮件:通过ID或sult获取一个帖子.
• 添加员额: 创建有标题,内容和状态的新职位.
• 编辑邮件: 以 ID 更新一个已存在的站点 .
• 删除员额:通过ID删除一个帖子.

成员

• 浏览成员: 列出带有过滤和页码的成员.
• 读取成员:通过ID或电子邮件获取成员.
• 添加成员: 创建新成员.
• 编辑成员: 更新成员详情.
• 删除成员: 删除一个成员.

通讯

• 浏览通讯: 列表通讯.
• 阅读通讯:通过身份证检索一份通讯.
• 添加通讯:创建新通讯.
• 编辑通讯: 更新通讯细节.
• 删除通讯: 删除通讯.

提议

• 浏览出借: 列出报价.
• 读取提议:通过身份证获取报价.
• 添加提议: 创建新报价.
• 编辑提供: 更新提供细节.
• 删除提议: 删除一个提议.

邀请

• 浏览邀请: 名单邀请.
• 添加邀请: 创建新邀请.
• 删除邀请: 删除邀请.

作用

• 浏览角色: 列出角色.
• 读取角色:通过ID获取一个角色.

标记

• 浏览标签:列表标签.
• 读取标记:通过ID或sult获取标签.
• 添加标记: 创建新标签.
• 编辑标记: 更新标签细节.
• 删除标记: 删除标签.

等级

• 浏览分层: 列表分级.
• 读取分级:通过ID获取一个分级.
• 添加等级: 创建新的分级.
• 编辑分级: 更新分级细节.
• 删除分级: 删除一层.

用户

• 浏览用户: 列出用户.
• 读取用户:通过ID或sult获取用户.
• 编辑用户: 更新用户细节.
• 删除用户: 删除一个用户.

网络呼号

• 浏览 Webhooks: 列出网友.
• 添加 Webhook: 创建新的webhook.
• 删除 Webhook:去掉一个网钩.

每个工具都可以通过MCP协议访问,可以从相容客户端中被引用. 详细参数的设置和使用,见源代码: src/tools/。 。 。 .

处理错误

幽灵MCP 服务器使用自定义 GhostError 处理 API 通信错误和处理问题的例外。 这将确保清晰和描述性的错误信息,以协助排除出故障.

捐款

1. 分叉仓库
2. 创建特性分支
3. 提交更改
4. 创建拉动请求

许可证

麻省理工学院