Ghost MCP Server

Ghost MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于通过 LLM 接口(如 Claude)与 Ghost CMS 进行交互。该服务通过 JWT 认证提供安全且全面的 Ghost 博客管理功能,包括文章、用户、会员、订阅等级、优惠活动和新闻简报的管理。

  • by RoyDGerkoeter
  • 更新于
在 GitHub 查看 RoyDGerkoeter/ghost-mcp

使用说明

基本能力

产品定位

Ghost MCP Server 是一个专为 Ghost CMS 设计的 MCP 服务,旨在通过 LLM 接口提供安全、高效的博客管理功能。

核心功能

  • 安全认证:使用 JWT 认证保护 Ghost Admin API 请求。
  • 全面实体访问:支持管理文章、用户、会员、订阅等级、优惠活动和新闻简报。
  • 高级搜索功能:提供模糊和精确匹配选项。
  • 详细输出:生成人类可读的 Ghost 实体信息。
  • 错误处理:使用自定义 GhostError 异常进行错误处理。
  • 日志支持:通过 MCP 上下文集成日志功能,便于故障排查。

适用场景

  • 通过 LLM 接口管理 Ghost 博客内容。
  • 自动化博客文章的创建、更新和删除。
  • 管理用户、会员和订阅等级。
  • 创建和管理优惠活动及新闻简报。

工具列表

  • ghost:核心工具,提供所有 Ghost CMS 功能。
    • 功能:支持文章、标签、用户、会员、订阅等级、优惠活动和新闻简报的管理。

常见问题解答

  • 依赖问题:确保 Python ≥ 3.12 和 Node.js 已安装。
  • 认证问题:检查 GHOST_API_URL 和 GHOST_STAFF_API_KEY 环境变量是否正确设置。
  • 错误处理:使用 GhostError 异常获取详细的错误信息。

使用教程

使用依赖

  • Python ≥ 3.12
  • Ghost 实例(推荐 v5.x+)
  • Node.js(用于测试 MCP Inspector)

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @MFYDev/ghost-mcp --client claude

手动安装

git clone git@github.com/mfydev/ghost-mcp.git
cd ghost-mcp
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -e .

调试方式

环境变量设置

export GHOST_API_URL=https://yourblog.com
export GHOST_STAFF_API_KEY=your_staff_api_key

测试 MCP Inspector

GHOST_API_URL=your_ghost_api_url GHOST_STAFF_API_KEY=your_staff_api_key npx @modelcontextprotocol/inspector uv --directory /path/to/ghost-mcp run src/main.py