@proars/ghost-mcp-server

中文文档

2.2.1发布于 2026/11/02MITES Module

MCP服务器的鬼CMS：管理帖子，页面，标签，SEO元数据，成员，新闻通讯和主题，通过鬼管理API从克劳德，光标和其他人工智能代理

文档目录10 节

快速启动
从源代码安装
服务器能做什么？
我如何称呼这些工具？
我如何到达没有专用工具的路线？
它需要哪些Ghost权限？
给AI客户端访问我的网站是安全的吗？
开发
常见问题解答
许可证

Ghost MCP服务器：从Claude， Cursor和其他AI客户端管理Ghost CMS

Ghost MCP Server是一个开源软件模型上下文协议用于Ghost CMS的服务器，用TypeScript编写。它连接一个MCP客户端，如克劳德桌面，克劳德代码或光标到Ghost管理API通过工作室。有了它，人工智能助手可以创建和编辑帖子和页面，设置SEO元数据，管理标签，成员和新闻通讯，上传图像和主题，以及导出内容。

它使 60的工具： 55个专用API工具，3个SEO和标签快捷方式，一个路由搜索和一个通用请求工具。内置目录包括 253个管理API路由 从固定的Ghost源快照中获取。什么在你的网站上工作取决于你的凭据，你的Ghost版本和它的功能标志。中列出了路由和源 GHOST_API.list.

Demo: Claude Code creates a draft post in Ghost through the MCP server

快速启动

你需要Node.js 20或更新版本，以及一个带有Admin API访问权限的Ghost站点。

在Ghost Admin中打开 设置→集成→添加自定义集成 然后复制 管理API密钥 （id:secret）. 不要使用Content API密钥。
将服务器添加到您的客户机配置中。对于克劳德桌面或光标：

{
  "mcpServers": {
    "ghost": {
      "command": "npx",
      "args": ["-y", "@proars/ghost-mcp-server"],
      "env": {
        "GHOST_API_URL": "https://your-blog.com",
        "GHOST_ADMIN_API_KEY": "64f1a2b3c4d5e6f7a8b9c0d1:3e5f7a9b1c2d4e6f8a0b2c4d6e8f0a1b3c5d7e9f1a2b4c6d8e0f2a3b5c7d9e1f"
      }
    }
  }
}

上面的键是一个实际格式的虚构示例：24个十六进制字符，一个冒号，然后是64个十六进制字符。用您自己的值替换这两个值。

运行服务器时使用 npx，通过设置 env 如图所示。一个 .env 文件只能从源签出（见下文）或路径中读取 GHOST_MCP_ENV_FILE.

重新启动客户端，询问类似“列出我最近的文章及其SEO标题。”

GHOST_API_URL 是规范的管理域，包括任何站点子目录，没有 /ghost/api/admin．对于本地站点，请使用如下地址 http://localhost:2368.

配置文件的位置：Claude Desktop在macOS上使用 ~/Library/Application Support/Claude/claude_desktop_config.json．游标使用 ~/.cursor/mcp.json 或者 .cursor/mcp.json 在你的项目中。

克劳德代码:

claude mcp add ghost --scope user \
  -e GHOST_API_URL=https://your-blog.com \
  -e GHOST_ADMIN_API_KEY=64f1a2b3c4d5e6f7a8b9c0d1:3e5f7a9b1c2d4e6f8a0b2c4d6e8f0a1b3c5d7e9f1a2b4c6d8e0f2a3b5c7d9e1f \
  -- npx -y @proars/ghost-mcp-server

--scope user 使服务器在每个文件夹中可用。如果没有它，服务器将仅为运行该命令的文件夹注册。Claude Code启动和停止服务器本身，因此您不需要保持终端打开。

检查与 claude mcp get ghost，它应该报告 Connected，或打字 /mcp 在一个 claude 会话。要删除服务器，运行命令 claude mcp remove ghost -s user.

任何其他stdio MCP客户端都可以运行相同的命令， npx -y @proars/ghost-mcp-server，使用两个环境变量。

更新: npx 使用缓存，所以 @latest 可能不会在每次启动时根据注册表进行检查。要在命令运行时强制进行注册表更新检查，请使用 npx --prefer-online -y @proars/ghost-mcp-server@latest．在JSON客户端配置中，设置 args :

["--prefer-online", "-y", "@proars/ghost-mcp-server@latest"]

例如，要保持在一个版本上，就把它钉上 @proars/[email protected]．看到更新日志查看每个版本中的变化。

不要跑 npx 从这个存储库的克隆中：NPM找到本地的 package.json 用同样的名字和失败 ghost-mcp-server: command not found．从任何其他文件夹运行它。

从源代码安装

如果要更改代码或运行未发布的版本，请使用此选项。

git clone https://github.com/proars/ghost-mcp-server.git
cd ghost-mcp-server
npm install
npm run build
cp .env.example .env

填写 GHOST_API_URL 和 GHOST_ADMIN_API_KEY 在 .env，然后将客户端指向构建。保持 --silentnpm的启动横幅将在stdout的MCP协议流中结束。

{
  "mcpServers": {
    "ghost": {
      "command": "npm",
      "args": ["--silent", "--prefix", "/ABSOLUTE/PATH/ghost-mcp-server", "start"]
    }
  }
}

这个 .env 无论客户端从哪个目录启动服务器，都会读取项目根目录中的文件。已经设置的变量具有优先级，如果设置了两个必需的变量，则根本不读取文件。 GHOST_MCP_ENV_FILE 选择一个不同的env文件，然后 GHOST_MCP_SKIP_DOTENV=1 关闭文件加载。

服务器能做什么？

资源	工具
的帖子	`get_posts`， `get_post`， `get_post_by_slug`， `create_post`， `update_post`， `delete_post`， `copy_post`
页面	`get_pages`， `get_page`， `get_page_by_slug`， `create_page`， `update_page`， `delete_page`， `copy_page`
标签	`get_tags`， `get_tag`， `get_tag_by_slug`， `create_tag`， `update_tag`， `delete_tag`
层	`get_tiers`， `get_tier`， `create_tier`， `update_tier`
时事通讯	`get_newsletters`， `get_newsletter`， `create_newsletter`， `update_newsletter`
提供了	`get_offers`， `get_offer`， `create_offer`， `update_offer`
成员	`get_members`， `get_member`， `create_member`， `update_member`， `delete_member`
标签	`get_labels`， `create_label`， `update_label`， `delete_label`
工作人员	`get_users`， `get_user`， `update_user`， `delete_user`， `get_roles`， `invite_user`
图片和主题	`upload_image`， `upload_theme`， `activate_theme`
人则	`create_webhook`， `update_webhook`， `delete_webhook`
网站	`get_site`， `get_settings`
快捷键	`update_post_seo`， `update_page_seo`， `update_post_tags`
发现和泛型调用	`ghost_list_endpoints`， `ghost_api_request`

Ghost没有层级、通讯或优惠的删除端点，所以这些资源没有 delete_* 工具。

警告：此服务器公开所有支持的函数，包括破坏性函数。 delete_post， delete_page， delete_tag， delete_member， delete_user， activate_theme， upload_theme 和 ghost_api_request 可以永久删除或覆盖内容，订阅者和网站设置。删除的记录通常无法恢复。为服务器创建一个单独的集成密钥，在批量工作之前从Ghost Admin导出内容的备份，并为所有人打开手动审批 update_*， delete_* 以及客户端的通用调用。

我如何称呼这些工具？

创建和更新： 输入记录字段 data 打破记录 id 作为一个单独的论点。帖子和页面更新需要 data.updated_at 从一个新鲜的阅读。搜索引擎优化捷径(update_post_seo， update_page_seo)和标签快捷方式 updated_at 直接。
列表: 使用 limit， page， filter， order， include 和 fields．默认情况下，帖子和页面返回时带有紧凑的字段和标签。单记录读取返回完整的记录。
搜索引擎优化: update_post_seo 和 update_page_seo 集 meta_title， meta_description， og_title 和 og_description 一个电话。通过 id，电流 updated_at 至少是其中一个领域。您遗漏的字段保持不变。
标签: 设置标记替换整个集合。将创建尚不存在的标记，空数组将删除所有标记。
出版: 呼叫 update_post 与 data.status="published"，或 "scheduled" 还有未来 data.published_at．要通过电子邮件发送邮件，请添加 newsletter （一段）及（任选） email_segment.
图片: upload_image 需要 file_path，可选 purpose （image， profile_image 或者 icon), ref.

我如何到达没有专用工具的路线？

使用 ghost_list_endpoints 按 group， method， access 或者 search．集 without_dedicated_tool=true 列出其他198条路由。每个条目显示访问要求、特性标志和上传字段。

调用任何路由 ghost_api_request．它的 path 是相对于 /ghost/api/admin，包含真实id或鼻涕虫，没有查询字符串。

ghost_api_request method=GET  path=/labels/slug/vip/
ghost_api_request method=POST path=/members/upload/ files={membersfile: "/Users/me/members.csv"}
ghost_api_request method=GET  path=/posts/export/   save_to="/Users/me/posts.csv"

发送JSON有效负载 body，使用Ghost所期望的结构。输入查询参数 query．发送多部分文件 files={formField: "/absolute/path"}，带有可选文本 fields.

下载, save_to 必须在现有的可写文件夹中命名新文件。尾随分隔符将被拒绝，并且永远不会覆盖现有文件。当POST、PUT或DELETE返回一个文件时，设置 save_to 在第一次调用时，因为重复一个突变来获得它的响应可以重复它的效果。

它需要哪些Ghost权限？

类	路线	要求
`I` / `PUBLIC`	125	集成键允许列表或公共访问。处理程序权限仍然适用。
`U`	116	具有所需角色或用户会话的人员用户访问令牌。
`SESSION`	3	用户cookie会话。集成密钥和人员令牌被阻止。
`FLOW`	9	登录、恢复和设置流程具有自己的身份验证。

要使用人员令牌，请将用户的Ghost Admin配置文件中的令牌放入 GHOST_ADMIN_API_KEY．其权限遵循用户的角色。人员令牌无法调用 DELETE /db/， PUT /users/owner/ 或者 POST /authentication/reset/.

服务器不实现cookie会话，登录或2FA。那些路线在目录中只允许发现。

请求发送 Accept-Version: v5.0．目录是幽灵的快照 main 分支，因此它包含可能在您的安装中返回404的较新的或实验性路由。不包括公共Content API。

给AI客户端访问我的网站是安全的吗？

把它当作任何对你的博客有写权限的帐户，并保持一个人在循环中。

把钥匙放在客户所在的环境或房间里 .env，千万不要犯。打开破坏性工具的手动审批：all update_* 和 delete_* 工具, activate_theme， upload_theme 和 ghost_api_request.
如果突变在发送后失败，请在重试之前检查Ghost，因为它可能已经通过了。使用读取工具检查截断响应的结果。
重定向永远不会被遵循。配置规范的Admin URL，并且在突变接收到重定向后，在发送另一个请求之前检查结果。
本地文件路径必须是绝对的。隐藏路径组件被拒绝，无论是在写入时还是在符号链接解析后。上传需要常规文件，下载在请求之前保留，具有仅属于所有者的权限。
文件检查不是沙盒。它们不会保护具有可见名称的敏感文件，也不会阻止本地进程在调用期间重写目录。将网站内容视为不可信，并审查上传请求。
上传和下载在内存中进行缓冲。HTTP请求在120秒后超时，超过100,000个字符的工具响应将被截断。

开发

npm run typecheck   # tsc --noEmit
npm test            # regression tests with synthetic credentials and a local fake Ghost server
npm run catalog     # regenerate src/catalog.ts from GHOST_API.list
npm run build       # compile to dist/
npm start           # run the build over stdio (requires configuration)

路由列表存在 GHOST_API.list. scripts/generate-catalog.mjs 把它变成 src/catalog.ts，你不应该手工编辑。要更改路由，请编辑列表，执行命令 npm run catalog然后进行测试日志转到标准输出，因为标准输出是为MCP消息保留的。

GitHub Actions会在Node 20和Node 22上运行类型检查、构建和测试 main 每一个拉请求。

这些测试检查目录和工具一致性、请求构造、文件安全性、重定向、重试指导和配置隔离。它们不能证明与实时Ghost实例的兼容性。

常见问题解答

它与自托管Ghost和Ghost（Pro）一起工作吗？ 是的，只要您可以访问管理API并拥有密钥。集 GHOST_API_URL 到API URL显示在您的自定义集成页面在鬼管理。这对Ghost（Pro）和自定义域名后面的网站最重要，因为服务器从不遵循重定向：重定向到另一个地址的地址将失败。

它支持哪些客户端？ 任何可以启动工作室服务器的MCP客户端，包括Claude Desktop， Claude Code和Cursor。

它能在没有管理员密钥的情况下读取我的公共内容吗？ 否。它只使用Admin API。不包括公共Content API。

它能删除我的内容吗？ 是， delete_post， delete_page 类似的工具是永久性的。在您的客户端中需要手动批准它们。

许可证

麻省理工学院.

版本与发布记录

@proars/ghost-mcp-server 共发布 5 个版本，首次发布于 2026/11/02；过去 12 个月发布了 5 个版本。

版本	发布日期	距今
`2.2.1`latest	2026/11/02	1 天前
`2.2.0`	2026/11/02	1 天前
`2.1.1`	2026/11/02	1 天前
`2.1.0`	2026/11/02	1 天前
`0.0.0-stage`	2026/11/02	1 天前

关于 @proars/ghost-mcp-server 的常见问题

@proars/ghost-mcp-server 是什么？

MCP服务器的鬼CMS：管理帖子，页面，标签，SEO元数据，成员，新闻通讯和主题，通过鬼管理API从克劳德，光标和其他人工智能代理

如何安装 @proars/ghost-mcp-server？

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

@proars/ghost-mcp-server 支持 TypeScript 吗？

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

@proars/ghost-mcp-server 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@proars/ghost-mcp-server 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@proars/ghost-mcp-server 可以商用吗？

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

@proars/ghost-mcp-server 还在维护吗？

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

npm install @proars/ghost-mcp-server

pnpmpnpm add @proars/ghost-mcp-server
yarnyarn add @proars/ghost-mcp-server
bunbun add @proars/ghost-mcp-server

命令行npx ghost-mcp-server

在你的项目目录中运行此命令。

最新版本2.2.1发布于 1 天前

开源许可MIT宽松许可

包体积98.1 kB10 个文件 · 解压后

运行依赖2 个

模块格式ES Module

TypeScript未声明类型可查找 @types/proars__ghost-mcp-server

Node.js>=20

发布版本5 个近 12 个月 5 个

首次发布2026/11/021 天前

元数据更新2026/11/02

每一个软件包背后，
都有分享与创造的人。