Ghost MCP Server

Ghost MCP Server

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

Overview

基本能力

产品定位

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_URLGHOST_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 [email protected]/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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。