使用说明

项目简介

Cursor Portal 项目旨在将各种数字工具集成到 Cursor 编辑器中，让你无需离开编辑器即可完成更多工作。本项目中的 Ghost MCP 服务器，专注于为 Cursor 提供 Ghost 博客平台的集成，让你可以在 Cursor 中直接撰写、编辑和发布博客文章到你的 Ghost 博客站点。

主要功能点

博客文章管理：
- 创建新的博客文章草稿或直接发布。
- 编辑已存在的博客文章，包括标题、内容和状态。
- 列出最近的博客文章，方便快速访问和管理。
- 删除不需要的博客文章。
多媒体内容集成：
- 上传本地图片、URL图片和Base64编码图片到 Ghost 博客媒体库。
- 将图片添加到博客文章中，支持指定图片位置和添加图片标题。
- 上传 HeyGen 视频到 Ghost 博客媒体库，并将视频添加到博客文章中。

安装步骤

克隆仓库:

git clone https://github.com/AdithyanI/cursor-portal.git
cd cursor-portal

安装依赖:

pip install -r servers/blog/requirements.txt

配置环境变量: 在 'servers/blog/' 目录下创建 '.env' 文件，并填入你的 Ghost 博客管理 API 相关信息和 HeyGen API Key（如果需要使用视频上传功能）。

GHOST_ADMIN_API_URL=你的Ghost博客API地址  # 例如: https://<your-ghost-domain>
GHOST_ADMIN_API_KEY=你的Ghost博客Admin API Key  # 格式为: <key_id>:<secret>
HEYGEN_API_KEY=你的HeyGen API Key (可选，如果需要使用视频上传功能)

请确保替换 '你的Ghost博客API地址'、'你的Ghost博客Admin API Key' 和 '你的HeyGen API Key' 为你自己的实际信息。

服务器配置

在 Cursor 编辑器设置中添加 MCP 服务器，配置信息如下：

{
    "servers": [
        {
            "name": "Ghost Blog MCP Server",
            "command": "/path/to/your/python3",  // 替换为你的python3可执行文件路径，例如 /usr/bin/python3 或 虚拟环境中的 python 路径
            "args": [
                "/path/to/cursor-portal/servers/blog/ghost_mcp_server.py" // 替换为 ghost_mcp_server.py 脚本的绝对路径
            ],
            "transport": "stdio"
        }
    ]
}

参数注释:

'name': MCP 服务器的名称，在 Cursor 中显示为服务器列表的名称，可以自定义。
'command': 启动 MCP 服务器的命令，通常是 Python 解释器的路径。你需要根据你的 Python 环境配置进行修改。如果使用虚拟环境，请使用虚拟环境中的 Python 路径。
'args': 传递给启动命令的参数，这里指定了 'ghost_mcp_server.py' 脚本的路径。你需要根据你的仓库克隆路径修改为 'ghost_mcp_server.py' 脚本的实际绝对路径。
'transport': MCP 服务器使用的传输协议，这里设置为 'stdio'，与 Cursor 兼容。

基本使用方法

启动 MCP 服务器: 在 Cursor 编辑器中添加上述服务器配置后，MCP 服务器会在 Cursor 启动时自动运行。
在 Cursor 中与 Claude Agent 对话: 打开 Cursor 的 Composer (Cmd+L)，选择 Claude agent。
使用 MCP 工具: 通过自然语言指示 Claude agent 使用 Ghost MCP 服务器提供的工具，例如：
- 创建博客文章: "我想创建一个新的博客文章，标题是 '我的第一篇博客'，内容是 'Hello from Cursor and Ghost!'"
- 列出最近文章: "列出最近的 5 篇博客文章"
- 编辑博客文章: "编辑 ID 为 'xxxxx' 的博客文章，将状态改为 'published'"
- 添加图片到文章: "给 ID 为 'yyyyy' 的博客文章添加一张图片，图片 URL 是 'https://example.com/image.png'"
Claude agent 会解析你的指令，并调用相应的 MCP 工具来完成操作。你可以参考 'servers/blog/ghost_mcp_server.py' 文件中定义的工具函数名和参数来更精确地指示 Claude agent。

注意: 使用前请确保已经正确配置了 '.env' 文件中的 Ghost API 相关信息，并且 Ghost 博客站点已正确配置允许 API 访问。

关键词