Ghost MCP Server

Ghost MCP Server

site icon
2025.04.11 2
JavaScript博客管理内容管理内容生成
Ghost MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务,允许 MCP 客户端(如 Cursor 或 Claude Desktop)通过定义的工具与 Ghost CMS 实例进行交互。该服务将 Ghost CMS 的管理功能暴露为 MCP 工具,使得 AI 客户端能够管理 Ghost 博客。
View on GitHub

Overview

基本能力

产品定位

Ghost MCP Server 是一个中间件服务,旨在通过 MCP 协议将 Ghost CMS 的管理功能暴露给 AI 客户端,实现自动化博客管理。

核心功能

  1. 标签管理:创建和获取 Ghost CMS 中的标签。
  2. 文章管理:创建新的博客文章,支持多种状态(草稿、已发布、计划发布)。
  3. 图片上传:上传图片到 Ghost CMS,用于文章的特色图片。

适用场景

  1. 自动化博客管理:通过 AI 客户端自动创建和管理博客内容。
  2. 批量内容生成:批量创建标签和文章,提高内容生产效率。
  3. 内容调度:计划发布文章,实现内容的时间控制。

工具列表

  1. ghost_create_tag:创建新标签。
  2. ghost_get_tags:获取现有标签。
  3. ghost_upload_image:上传图片到 Ghost CMS。
  4. ghost_create_post:创建新文章。

常见问题解答

  1. 401 Unauthorized Error from Ghost:检查 .env 文件中的 GHOST_ADMIN_API_URLGHOST_ADMIN_API_KEY 是否正确。
  2. MCP Server Connection Issues:确保 MCP 服务器正在运行,检查端口是否被防火墙阻止。
  3. Tool Execution Errors:检查服务器控制台日志,查看具体错误信息。
  4. Dependency Installation Issues:确保安装了兼容的 Node.js 版本,尝试重新安装依赖。

使用教程

使用依赖

  1. Node.js 14.0.0 或更高版本:确保已安装 Node.js。
  2. Ghost Admin API URL 和 Key:从 Ghost Admin 设置中获取。

安装教程

  1. 克隆仓库bash git clone <repository_url> cd ghost-mcp-server
  2. 安装依赖bash npm install
  3. 配置环境变量:创建 .env 文件并添加 Ghost Admin API 凭证: dotenv GHOST_ADMIN_API_URL=https://your-ghost-site.com GHOST_ADMIN_API_KEY=your_admin_api_key
  4. 运行服务器bash npm start
  5. 开发模式bash npm run dev

调试方式

  1. 检查服务器日志:查看控制台日志,确认服务器是否正常运行。
  2. 验证端口:确保 MCP 服务器端口(默认 3001)未被占用。
  3. 测试工具:使用 MCP 客户端连接并测试工具功能。

许可证

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