TurboPush MCP Server

TurboPush 的 MCP (Model Context Protocol) Server，让 Claude 等大模型通过标准 MCP 协议直接调用 TurboPush 的内容发布能力。

架构

Claude (Claude Code / Claude Desktop)
  │
  │  MCP 协议 (stdio)
  │
  ▼
turbo-push-mcp (本项目)
  │
  │  HTTP REST API
  │
  ▼
TurboPush 服务 (127.0.0.1:{port})

MCP Server 作为独立进程运行，通过 HTTP 代理方式调用 TurboPush 现有 REST API，对主服务零侵入。

一键安装（推荐）

脚本会根据当前系统自动下载对应平台的二进制，放到 ~/.local/bin/turbo-push-mcp，并在检测到 claude CLI 时自动执行 claude mcp add turbo-push 完成注册。

curl -fsSL https://raw.githubusercontent.com/xueyc1f/turbopush-mcp/main/install.sh | sh

可选参数（环境变量方式传入）：

示例：安装指定版本到 /usr/local/bin

curl -fsSL https://raw.githubusercontent.com/xueyc1f/turbopush-mcp/main/install.sh \
  | VERSION=v1.1.1 INSTALL_DIR=/usr/local/bin sh

安装完成后重启 Claude Code 即可使用。若未自动注册，可手动执行：

claude mcp add turbo-push -- ~/.local/bin/turbo-push-mcp

Windows 用户请前往 Releases 页面手动下载 turbo-push-mcp-x86_64-pc-windows-msvc.exe。

从源码编译

需要 Go 1.25+。

go build -o turbo-push-mcp .

国内环境如遇网络问题，可设置代理：

GOPROXY=https://goproxy.cn,direct go build -o turbo-push-mcp .

配置

MCP Server 通过环境变量连接 TurboPush 服务：

TurboPush 每次启动时会生成随机端口和 Token，并且自动设置。

Claude Code

编辑 ~/.claude/settings.json（全局）或项目目录下 .claude/settings.json：

{
  "mcpServers": {
    "turbo-push": {
      "command": "/绝对路径/mcp/turbo-push-mcp"
    }
  }
}

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "turbo-push": {
      "command": "/绝对路径/mcp/turbo-push-mcp"
    }
  }
}

手动验证

TURBO_PUSH_PORT=12345 TURBO_PUSH_AUTH=xxx ./turbo-push-mcp

启动后会通过 stdin/stdout 进行 MCP 通信，可用 MCP Inspector 调试。

可用 Tools

共 18 个 Tool，覆盖完整发布流程：

平台

账号

平台配置

内容管理

发布

发布记录

典型工作流

在 Claude 中可以这样使用：

> 帮我查看有哪些已登录的抖音账号

> 创建一篇文章，标题"产品更新公告"，内容为 ...

> 把这篇文章发布到所有已登录的微信公众号账号

Claude 会自动编排调用：list_logged_accounts → create_article → publish_article。

发布参数示例

发布时需要构造 postAccounts 数组：

{
  "article_id": 1,
  "postAccounts": [
    {
      "id": 10,
      "platName": "抖音账号A",
      "settings": {
        "platType": "douyin",
        "allowSave": true,
        "lookScope": 0
      }
    }
  ]
}

settings.platType 对应平台标识：

各平台 settings 的完整字段说明见 docs/api.md 中的 setting 参数说明 章节。

定时发布示例

如需定时发布，请在 settings 中添加 timerPublish 字段：

{
  "article_id": 1,
  "postAccounts": [
    {
      "id": 10,
      "platName": "小红书",
      "settings": {
        "platType": "xiaohongshu",
        "timerPublish": {
          "enable": true,
          "timer": "2025-04-25 15:54:00"
        }
      }
    }
  ]
}

注意：不同平台对定时发布的时间范围限制不同，请参考 docs/api.md 中的详细说明。

Skills 集成

OpenClaw

将 mcp/skills/turbo-push/ 目录复制到 OpenClaw 的 skills 目录：

cp -r mcp/skills/turbo-push ~/.openclaw/workspace/skills/

重启 OpenClaw 或刷新 skills 即可使用。Skill 会自动配置 MCP Server 连接。

Claude Code

项目已内置 3 个 slash command（位于 .claude/commands/）：

使用示例：

/publish 把这篇文章发到所有抖音账号
/publish-all 标题"新品上线" 内容为...
/status 查看最近的发布记录