使用说明
基本能力
产品定位
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
