Ghost Admin API

🚀 鬼魂 MCP 服务器

鬼魂 MCP 服务器是一个结合了 Ghost 管理控制台 API 的 Model Context Protocol (MCP) 服务器。它能让您通过编程方式访问 Ghost CMS 的各类功能，如文章管理、页面管理和成员管理等。

🚀 快速开始

鬼魂 MCP 服务器能帮助您以编程方式与 Ghost CMS 交互。您可以按照以下步骤快速开启使用。

✨ 主要特性

• 文章管理：支持创建、读取、更新、删除和搜索文章。
• 页面管理：可进行页面的创建、读取、更新和删除操作。
• 标签管理：方便对文章标签进行管理。
• 作者管理：有效管理文章作者信息。
• 成员管理：支持成员的创建、读取、更新、删除和搜索。
• 图片上传支持：允许上传图片到系统中。

📦 安装指南

先决条件

• Node.js（推荐使用 v18 或更高版本）
• Ghost CMS 实例
• Ghost 管理 API 密钥

安装步骤

使用 npm 安装包：

npm install @mtane0412/ghost-mcp-server

📚 详细文档

配置

1. 在您的 Ghost 管理控制台仪表盘中创建一个新的自定义集成，位于设置 > 集成。
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_pages

获取页面列表。 输入：

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

get_tags

获取标签列表。 输入：

{
  "limit": "number", // 可选：要获取的标签数量（1-100，默认值：10）
  "page": "number"   // 可选：页码（默认值：1）
}

get_authors

获取作者列表。 输入：

{
  "limit": "number", // 可选：要获取的作者数量（1-100，默认值：10）
  "page": "number"   // 可选：页码（默认值：1）
}

get_members

获取成员列表。 输入：

{
  "limit": "number", // 可选：要获取的成员数量（1-100，默认值：10）
  "page": "number"   // 可选：页码（默认值：1）
}

upload_image

上传图片。 输入：

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

调试

由于 MCP 服务器通过标准输入和输出进行通信，调试可能会比较困难。我们推荐使用 MCP 检查器，这是一个作为包脚本提供的工具：

npm run inspect

检查器会在您的浏览器中提供一个访问调试工具的 URL。

📄 许可证

本项目采用 MIT 许可证。