项目简介

Ghost MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接大型语言模型 (LLM) 客户端与 Ghost 内容管理系统 (CMS)。通过此服务器，LLM 客户端可以安全、便捷地访问和管理 Ghost 博客的内容及功能，例如文章、标签、用户、会员等。

主要功能点

安全访问 Ghost CMS: 通过 JWT 认证，安全地连接到您的 Ghost 博客 Admin API。
全面的实体管理: 提供对文章 (posts)、用户 (users)、会员 (members)、会员等级 (tiers)、优惠 (offers)、新闻订阅 (newsletters) 和站点信息等 Ghost CMS 核心实体的访问和管理工具。
强大的内容操作: 支持文章的检索（关键词搜索、列表展示）、读取、创建、更新和删除等操作，以及标签、用户、会员等实体的管理功能。
结构化数据输出: 以易于 LLM 理解和处理的 JSON 格式或人类可读的文本格式返回 Ghost CMS 的数据。
灵活的 Prompt 交互: 内置 Prompt 模板，支持定制化的 LLM 交互模式，例如博客内容搜索和摘要生成。
详细的日志记录: 通过 MCP 上下文提供集成的日志支持，方便问题追踪和故障排除。

安装步骤

手动安装

克隆仓库

git clone [email protected]/mfydev/ghost-mcp.git
cd ghost-mcp

创建虚拟环境并安装

uv venv
source .venv/bin/activate   # Linux/macOS
.venv\Scripts\activate      # Windows
uv pip install -e .

环境变量配置

在使用 Ghost MCP Server 之前，您需要设置以下环境变量，用于连接您的 Ghost 博客：

export GHOST_API_URL=https://yourblog.com  # 您的 Ghost Admin API URL，例如：https://your-ghost-blog.com
export GHOST_STAFF_API_KEY=your_staff_api_key # 您的 Ghost Staff API Key，请在 Ghost 后台集成页面创建

注意：请将 'https://yourblog.com' 替换为您的 Ghost 博客的实际 API URL，并将 'your_staff_api_key' 替换为您的 Ghost Staff API Key。

服务器配置

以下是配置 MCP 客户端（例如 Claude Desktop）连接到 Ghost MCP Server 的 JSON 配置示例。您需要将此配置添加到您的 MCP 客户端的配置文件中。

{
  "mcpServers": {
    "ghost": {  // server name：服务器名称，可以自定义，用于在客户端中标识此服务器
      "command": "/Users/username/.local/bin/uv", // MCP服务器启动命令：指向 Python 虚拟环境中的 uv 可执行文件。请根据您的实际 uv 路径进行调整。
      "args": [  // MCP服务器启动参数：传递给启动命令的参数
        "--directory",  // 参数：指定工作目录
        "/path/to/ghost-mcp", // 参数值：Ghost MCP Server 仓库的本地路径，请替换为您的实际路径
        "run",       // 参数：运行命令
        "src/main.py" // 参数：指定要运行的 Python 主脚本
      ],
      "env": {  // 环境变量配置：传递给 MCP 服务器的环境变量
        "GHOST_API_URL": "your_ghost_api_url", // 环境变量：您的 Ghost 博客 API URL，请替换为您的实际 API URL
        "GHOST_STAFF_API_KEY": "your_staff_api_key" // 环境变量：您的 Ghost Staff API Key，请替换为您的实际 API Key
      }
    }
  }
}

请注意：

'server name' 可以自定义，用于在客户端配置文件中唯一标识此服务器连接。
'command' 和 'args' 需要根据您的 Python 虚拟环境和 Ghost MCP Server 仓库的实际路径进行调整。
'env' 中的 'GHOST_API_URL' 和 'GHOST_STAFF_API_KEY' 必须替换为您的 Ghost 博客的真实 API URL 和 Staff API Key。

基本使用方法

确保 Ghost MCP Server 已成功安装并配置了正确的环境变量。
启动 MCP 客户端，并加载包含上述服务器配置的配置文件。
在 MCP 客户端中，您可以使用预定义的工具 (Tools) 和资源 (Resources) 与您的 Ghost 博客进行交互。例如，您可以使用 'list_posts' 工具列出博客文章，或使用 'read_post' 工具读取特定文章的内容。
利用 Prompt 模板 (Prompts) 可以构建更复杂的交互逻辑，例如使用 'search_blog' Prompt 引导 LLM 进行博客内容搜索。

具体工具和资源的使用方法请参考仓库 README.md 文件中 "Available Tools" 和 "Available Resources" 部分的详细说明。

关键词