Ghost MCP 服务器

一个模型上下文协议 (MCP) 服务器，与 Ghost Admin API 集成。 此服务器支持以编程方式访问 Ghost CMS 功能，包括文章管理、页面管理、成员管理等。

功能

• 文章管理（创建、读取、更新、删除、搜索）
• 页面管理（创建、读取、更新、删除）
• 标签管理
• 作者管理
• 成员管理（创建、读取、更新、删除、搜索）
• 图片上传支持

前提条件

• Node.js (推荐 v18 或更高版本)
• Ghost CMS 实例
• Ghost Admin API 密钥

安装

使用 npm 安装包：

npm install @mtane0412/ghost-mcp-server

配置

1. 在 Ghost Admin 仪表板的“设置”>“集成”下创建一个新的自定义集成。

2. 设置以下环境变量：

# macOS/Linux
export GHOST_URL="https://your-ghost-blog.com"
export GHOST_ADMIN_API_KEY="your_admin_api_key"

# Windows (PowerShell)
$env:GHOST_URL="https://your-ghost-blog.com"
$env:GHOST_ADMIN_API_KEY="your_admin_api_key"

或者，您可以创建一个 .env 文件：

GHOST_URL=https://your-ghost-blog.com
GHOST_ADMIN_API_KEY=your_admin_api_key

用法

安装后，使用以下命令启动服务器：

npx @mtane0412/ghost-mcp-server

可用工具

get_posts

检索博客文章列表。

输入:

{
  "limit": "number", // 可选：要检索的文章数量（1-100，默认值：10）
  "page": "number"   // 可选：页码（默认值：1）
}

get_post

按 ID 检索特定文章。

输入:

{
  "id": "string" // 必需：文章 ID
}

search_posts

搜索文章。

输入:

{
  "query": "string", // 必需：搜索查询
  "limit": "number"  // 可选：要检索的文章数量（1-100，默认值：10）
}

create_post

创建新文章。

输入:

{
  "title": "string",     // 必需：文章标题
  "html": "string",      // 可选：HTML 内容
  "lexical": "string",   // 可选：Lexical 内容
  "status": "string",    // 可选：文章状态（published/draft/scheduled）
  "visibility": "string" // 可选：可见性级别（public/members/paid/tiers）
}

update_post

更新现有文章。

输入:

{
  "id": "string",       // 必需：文章 ID
  "title": "string",    // 可选：文章标题
  "html": "string",     // 可选：HTML 内容
  "lexical": "string",  // 可选：Lexical 内容
  "status": "string"    // 可选：文章状态
}

delete_post

删除文章。

输入:

{
  "id": "string" // 必需：文章 ID
}

get_pages

检索页面列表。

输入:

{
  "limit": "number",     // 可选：要检索的页面数量（1-100，默认值：10）
  "page": "number",      // 可选：页码（默认值：1）
  "order": "string",     // 可选：排序方式
  "formats": ["string"], // 可选：内容格式（html/mobiledoc/lexical）
  "include": ["string"]  // 可选：要包含的相关数据（authors/tags）
}

get_members

检索成员列表。

输入:

{
  "limit": "number",     // 可选：要检索的成员数量（1-100，默认值：10）
  "page": "number",      // 可选：页码（默认值：1）
  "order": "string",     // 可选：排序方式
  "include": ["string"]  // 可选：要包含的相关数据（labels/newsletters）
}

search_members

搜索成员。

输入:

{
  "query": "string",     // 必需：搜索查询
  "limit": "number",     // 可选：要检索的成员数量（1-100，默认值：10）
  "include": ["string"]  // 可选：要包含的相关数据（labels/newsletters）
}

upload_image

上传图片。

输入:

{
  "file": "string",   // 必需：Base64 编码的图像数据
  "purpose": "string" // 可选：图像用途（image/profile_image/icon）
}

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。 我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspect

Inspector 将提供一个 URL，用于访问浏览器中的调试工具。

许可证

MIT 许可证