XT

xueyc1f/turbopush-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

35 stars 8 forks 质量 71 趋势 20MIT

TurboPush MCP 服务器——连接 AI 代理(Claude、OpenClaw),通过模型上下文协议在包括微信、抖音、哔哔哔、小红书等 20+ 个平台上发布内容。

概览

TurboPush 的 MCP (Model Context Protocol) Server,让 Claude 等大模型通过标准 MCP 协议直接调用 TurboPush 的内容发布能力。 MCP Server 作为独立进程运行,通过 HTTP 代理方式调用 TurboPush 现有 REST API,对主服务零侵入。 脚本会根据当前系统自动下载对应平台的二进制,放到 ~/.local/bin/turbo-push-mcp,并在检测到 claude CLI 时自动执行 claude mcp add turbo-push 完成注册。 Windows 用户请前往 Releases 页面手动下载 turbo-push-mcp-x86_64-pc-windows-msvc.exe。 编辑 ~/.claude/settings.json(全局)或项目目录下 .claude/settings.json: 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json(macOS): 启动后会通过 stdin/stdout 进行 MCP 通信,可用 MCP Inspector 调试。 Claude 会自动编排调用:list_logged_accounts → create_article → publish_article。

概述(AI 翻译)

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

架构

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

一键安装(推荐)

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

可选参数(环境变量方式传入):

变量 说明 默认值
[VERSION 指定版本,如 v1.1.1 最新发布
INSTALL_DIR 安装目录 $HOME/.local/bin
SKIP_MCP_ADD 设为 1 跳过自动注册 0

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

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

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

从源码编译

需要 Go 1.25+。

国内环境如遇网络问题,可设置代理:

配置

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

环境变量 说明
TURBO_PUSH_PORT TurboPush 服务端口(非必需)
TURBO_PUSH_AUTH TurboPush 认证 Token(非必需)

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

克劳德·科德

编辑 ~/.claude/settings.json(全局)或项目目录下 .claude/settings.json:

克劳德桌面

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json(macOS):

手动验证

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

可用 工具

共 18 个 Tool,覆盖完整发布流程:

平台

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

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

可选参数(环境变量方式传入):

变量 说明 默认值
VERSION 指定版本,如 v1.1.1 最新 release
INSTALL_DIR 安装目录 $HOME/.local/bin
SKIP_MCP_ADD 设为 1 跳过自动注册 0

示例:安装指定版本到 /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 服务:

环境变量 说明
TURBO_PUSH_PORT TurboPush 服务端口(非必需)
TURBO_PUSH_AUTH TurboPush 认证 Token(非必需)

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,覆盖完整发布流程:

平台

Tool 说明
list_platforms 获取支持的发布平台列表

账号

Tool 说明
list_accounts 获取所有平台账号
list_logged_accounts 获取已登录的账号

平台配置

Tool 说明
list_platform_settings 获取平台配置列表
create_platform_setting 创建平台配置
update_platform_setting 更新平台配置
delete_platform_setting 删除平台配置

内容管理

Tool 说明
list_articles 获取内容列表
get_article 获取内容详情
create_article 创建文章
create_graph_text 创建图文
create_video 创建视频
update_article 更新内容
delete_article 删除内容

发布

Tool 说明
publish_article 发布文章到指定账号
publish_graph_text 发布图文到指定账号
publish_video 发布视频到指定账号

发布记录

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

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