JinDaGe - Ghost Admin API MCP Details

article

README

🚀 鬼魂 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

📚 详细文档

配置

在您的 Ghost 管理控制台仪表盘中创建一个新的自定义集成，路径为：设置 > 集成。
设置以下环境变量：

# 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 许可证。

Ghost Admin API