# @fanyangmeng/ghost-mcp 中文文档

规范地址：https://npmcn.com/package/%40fanyangmeng/ghost-mcp/

版本：0\.2\.0
npm 元数据更新时间：2026-04-19T17:13:26.958Z
中文译文更新时间：2026-11-14T10:04:51.668Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fanyangmeng/ghost-mcp
原文对照：https://npmcn.com/package/%40fanyangmeng/ghost-mcp/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：51.3 kB，19 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：4 个
- 首次发布：2025-04-20T20:01:06.927Z
- 最新版本发布：2026-04-19T17:13:26.852Z
- 近 30 天下载量：101913（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 1 个）

## 中文简介

使用 Ghost API 的 MCP 服务器

## 安装

```sh
npm install @fanyangmeng/ghost-mcp
```

也可以使用：`pnpm add @fanyangmeng/ghost-mcp`、`yarn add @fanyangmeng/ghost-mcp`、`bun add @fanyangmeng/ghost-mcp`

## README

# 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工具来管理帖子、用户、成员、等级、提议和通讯.

![demo](https://npmcn.com/package/%40fanyangmeng/ghost-mcp/assets/ghost-mcp-demo.gif)

## 特征

-   使用 Ghost 管理员 API 请求 `@tryghost/admin-api`
-   实体的全面访问,包括员额、用户、成员、级别、提议和通讯
-   具有模糊和精确匹配选项的高级搜索功能
-   Ghost 实体的详细、人可读输出
-   使用自定义进行强力错误处理 `GhostError` 例外情况
-   通过MCP环境提供综合记录支持,以加强故障排除

## 使用量

要与 MCP 客户端使用, 例如 Claude Desktop , 在您添加以下内容 `claude_desktop_config.json`数字 :

```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.  创建拉动请求

## 许可证

麻省理工学院

## 常见问题

### @fanyangmeng/ghost-mcp 是什么？

使用 Ghost API 的 MCP 服务器

### 如何安装 @fanyangmeng/ghost-mcp？

在项目目录运行 npm install @fanyangmeng/ghost-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ghost-mcp，可以用 npx ghost-mcp 直接运行。

### @fanyangmeng/ghost-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fanyangmeng\_\_ghost-mcp 是否存在。

### @fanyangmeng/ghost-mcp 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @fanyangmeng/ghost-mcp 可以商用吗？

@fanyangmeng/ghost-mcp 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fanyangmeng/ghost-mcp 的下载量有多少？

根据 npm 官方下载统计，@fanyangmeng/ghost-mcp 在 2026/10/15 – 2026/11/13 这 30 天内被下载 101,913 次，日均约 3,397 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fanyangmeng/ghost-mcp 还在维护吗？

最新版本 0\.2\.0 发布于 2026/04/20（6 个月前）；至今共发布 6 个版本，其中过去 12 个月发布了 1 个；首次发布于 2025/04/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。