返回 MCP 目录
public公开dns本地运行

ghost-mcp-server

一个将Ghost CMS与Claude AI通过FastMCP框架集成的服务器项目,支持通过Claude直接创建和管理Ghost博客内容。

article

README

🚀 亡灵MCP服务器

亡灵MCP服务器是一个借助FastMCP框架,将Ghost CMS与Claude AI集成的服务器,实现了两者之间的高效协作,为用户提供便捷的博客文章创建体验。

🚀 快速开始

✨ 主要特性

  • 通过FastMCP框架集成Ghost CMS与Claude AI。
  • 可在Claude中使用ghost_post工具直接在Ghost CMS创建博客文章。

📦 安装指南

安装需求

  • Python 3.11+版本
  • uv - 运行此服务器所需

安装步骤

  1. 克隆仓库。
  2. 创建虚拟环境(可选但推荐):
    uv venv
    
    激活虚拟环境:在Windows上使用.venv\Scripts\activate,其他系统使用source .venv/bin/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中使用ghost_post工具直接在Ghost CMS创建博客文章:

创建一篇标题为"My First Post"、内容为"Hello, world!"的博客文章

高级用法

该工具支持以下参数:

  • title:博客文章的标题
  • content:帖子的Markdown内容
  • author_id:作者ID(默认:"1")
  • tags:标签名称列表
  • status:帖子状态(草稿,已发布)
  • feature_image:帖子封面图片的URL
  • code_language:代码块的默认语言

Claude Desktop配置

要在Claude Desktop中使用此服务器,请按照以下步骤进行MCP设置:

  1. 打开Claude Desktop。
  2. 转到设置 > 开发者 > MCP服务器。
  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替换为此项目目录的绝对路径。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端