qpost-mcp

qpost-mcp

适用于 QPost 的 MCP 服务——通过 QPost 的 REST API，让 AI Agent 能够为 YouTube、TikTok 和 Instagram 安排视频／图片帖子的发布时间并发布。

安装

在 QPost 控制面板中生成 API 密钥（Settings → API Keys），然后选择以下两种方式之一。

托管版（推荐——无需安装）

QPost 在 https://qpost.dev/mcp 上通过 Streamable HTTP 运行同一个服务：

claude mcp add --transport http qpost https://qpost.dev/mcp \
  --header "x-api-key: YOUR_API_KEY"

任何支持 Streamable HTTP 的 MCP 客户端都可以将该 URL 与 x-api-key（或 Authorization: Bearer）请求头配合使用。此端点是无状态的，因此无需管理会话。

本地版（stdio），通过 npx 运行

如果你自行托管 QPost，或更愿意自己运行服务，请使用此方式：

claude mcp add qpost -e QPOST_API_KEY=your_key_here -- npx -y qpost-mcp

Claude Desktop / 其他 MCP 客户端

{
  "mcpServers": {
    "qpost": {
      "command": "npx",
      "args": ["-y", "qpost-mcp"],
      "env": {
        "QPOST_API_KEY": "your_key_here"
      }
    }
  }
}

如果你自行托管 QPost，也要设置 QPOST_BASE_URL（默认值为 https://qpost.dev）。

工具

工具	描述
list_connected_accounts	列出已连接的 YouTube/TikTok/Instagram 账号及其状态
create_post	创建并发布（或安排发布）帖子，支持通过 URL 或本地路径提供视频或图片媒体
list_posts	列出帖子，可按状态／平台筛选
get_post	按 ID 获取单个帖子
update_post	更新帖子的说明文字／发布时间／时区／状态
delete_post	删除帖子
retry_post	重试发布失败的帖子

不同传输方式的媒体处理有所不同

本地 stdio 服务可以读取你电脑上的文件，因此 create_post 除了接受 mediaUrl，也接受 mediaPath。托管端点显然无法访问你的磁盘——它接受 mediaUrl／imageUrls，也接受 mediaBase64，并可选用 mediaFilename 设置 MIME 类型。

完整的请求／响应格式及各平台的元数据选项（YouTube 类别／隐私设置、TikTok 隐私级别、Instagram 媒体类型等）请参阅 qpost.dev/docs——此服务只是同一 REST API 的轻量封装。

本地开发

npm install
npm run dev   # runs src/index.ts directly via tsx
npm run build # compiles to dist/

许可证

MIT