Ghost MCP Server

Ghost MCP 服务

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

功能

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

前提条件

• Node.js（建议使用 v18 或更高版本）
• Ghost CMS 实例
• Ghost Admin API 密钥

安装

使用 npm 安装软件包：

npm install @mtane0412/ghost-mcp-server

配置

1. 在 Ghost 管理后台的 Settings > Integrations 下创建新的自定义集成。

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", // Optional: Number of posts to retrieve (1-100, default: 10)
  "page": "number"   // Optional: Page number (default: 1)
}

get_post

按 ID 获取指定文章。

输入：

{
  "id": "string" // Required: Post ID
}

search_posts

搜索文章。

输入：

{
  "query": "string", // Required: Search query
  "limit": "number"  // Optional: Number of posts to retrieve (1-100, default: 10)
}

create_post

创建新文章。

输入：

{
  "title": "string",     // Required: Post title
  "html": "string",      // Optional: HTML content
  "lexical": "string",   // Optional: Lexical content
  "status": "string",    // Optional: Post status (published/draft/scheduled)
  "visibility": "string" // Optional: Visibility level (public/members/paid/tiers)
}

update_post

更新现有文章。

输入：

{
  "id": "string",       // Required: Post ID
  "title": "string",    // Optional: Post title
  "html": "string",     // Optional: HTML content
  "lexical": "string",  // Optional: Lexical content
  "status": "string"    // Optional: Post status
}

delete_post

删除文章。

输入：

{
  "id": "string" // Required: Post ID
}

get_pages

获取页面列表。

输入：

{
  "limit": "number",     // Optional: Number of pages to retrieve (1-100, default: 10)
  "page": "number",      // Optional: Page number (default: 1)
  "order": "string",     // Optional: Sort order
  "formats": ["string"], // Optional: Content formats (html/mobiledoc/lexical)
  "include": ["string"]  // Optional: Related data to include (authors/tags)
}

get_members

获取成员列表。

输入：

{
  "limit": "number",     // Optional: Number of members to retrieve (1-100, default: 10)
  "page": "number",      // Optional: Page number (default: 1)
  "order": "string",     // Optional: Sort order
  "include": ["string"]  // Optional: Related data to include (labels/newsletters)
}

search_members

搜索成员。

输入：

{
  "query": "string",     // Required: Search query
  "limit": "number",     // Optional: Number of members to retrieve (1-100, default: 10)
  "include": ["string"]  // Optional: Related data to include (labels/newsletters)
}

upload_image

上传图片。

输入：

{
  "file": "string",   // Required: Base64 encoded image data
  "purpose": "string" // Optional: Image purpose (image/profile_image/icon)
}

调试

由于 MCP 服务通过标准输入输出（stdio）通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它可通过软件包脚本运行：

npm run inspect

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

许可证

MIT 许可证