Ghost MCP Server

Ghost MCP Server

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

Overview

基本能力

产品定位

Ghost MCP Server 是一个用于管理 Ghost CMS 内容的服务,通过 MCP 协议提供安全的 API 访问和丰富的管理功能。

核心功能

  • 安全的 JWT 认证,用于 Ghost Admin API 请求
  • 全面的实体访问,包括文章、用户、会员、等级、优惠和新闻稿
  • 高级搜索功能,支持模糊和精确匹配
  • 详细且易读的 Ghost 实体输出
  • 使用自定义 GhostError 异常进行健壮的错误处理
  • 通过 MCP 上下文集成日志支持,便于故障排查

适用场景

  • 通过 LLM 接口管理 Ghost 博客内容
  • 自动化 Ghost CMS 的内容发布和管理
  • 集成 Ghost CMS 到其他应用或工作流中

工具列表

  • ghost: 提供所有 Ghost CMS 功能的统一工具
  • 支持多种操作,如列出文章、搜索文章、创建/更新/删除文章、管理标签、用户、会员、等级、优惠和新闻稿等

常见问题解答

  • 需要 Python 3.12 或更高版本
  • 需要运行 Ghost 实例并具有 Admin API 访问权限
  • 需要 Node.js 用于 MCP Inspector 测试

使用教程

使用依赖

  • 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 .

调试方式

环境变量设置

GHOST_API_URL=https://yourblog.com
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 了解完整条款。