Ghost MCP Server

Ghost MCP 服务

通过 FastMCP 框架将 Ghost CMS 与 Claude AI 集成的服务。

要求

• Python 3.11+
• uv - 运行此服务所必需

设置

1. 克隆仓库
2. 创建虚拟环境（可选，但推荐）：

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. 使用 uv 安装依赖项（依赖项定义在 pyproject.toml 中）：

   uv pip install .
   

4. 将 .env.example 复制为 .env，设置环境变量：

   cp .env.example .env
   

5. 在 .env 文件中配置 Ghost API 凭据：

   GHOST_API_KEY=your_ghost_api_key_here
   GHOST_API_URL=https://your-ghost-blog.com/ghost/api/admin/posts
   GHOST_API_VERSION=v5.116.1
   

Claude Desktop 配置

要将此服务与 Claude Desktop 搭配使用，需要在 Claude 的 MCP 设置中进行配置：

1. 打开 Claude Desktop
2. 转到 Settings > Developer > MCP Servers
3. 添加类似以下内容的 MCP 服务配置：

{
  "mcpServers": {
    "ghost-mcp": {
      "command": "/path/to/your/uv",
      "args": [
        "--directory",
        "/path/to/your/ghost-mcp",
        "run",
        "mcp_server.py"
      ]
    }
  }
}

将 /path/to/your/uv 替换为 uv 可执行文件的实际路径，并将 /path/to/your/ghost-mcp 替换为此项目目录的绝对路径。

使用方法

配置完成后，可以在 Claude 中使用 ghost_post 工具，直接在 Ghost CMS 中创建博客文章：

Create a blog post with title "My First Post" and content "Hello, world!"

该工具支持以下参数：

• title：博客文章的标题
• content：文章的 Markdown 内容
• author_id：作者 ID（默认值："1"）
• tags：标签名称列表
• status：文章状态（draft、published）
• feature_image：文章封面图片的 URL
• code_language：代码块的默认语言