Recurpost

RecurPost MCP 服务

一个 MCP（Model Context Protocol） 服务，可让 AI 助手访问 RecurPost 社交媒体管理 API。

它能做什么？

• 列出已连接的社交账号和内容库
• 列出工作区，并在你所属的任意工作区中工作
• 立即发布内容，或安排稍后发布
• 将内容添加到内容库，以便定期发布或长期使用
• 查看包含互动指标的发布历史
• 使用 AI 生成社交媒体内容和图片
• 获取连接新社交账号的链接

设置

1. 获取 API 密钥

1. 登录 RecurPost
2. 前往 Account Settings
3. 生成 API Password Key（这不是你的登录密码）

2. 安装

Claude Desktop（推荐）：一键扩展

适用于 macOS 和 Windows。无需安装其他内容：Claude Desktop 使用自带的 Node.js 运行扩展。

1. 下载 recurpost.mcpb。
2. 双击文件（或将其拖到 Claude Desktop 的 Settings > Extensions 中），然后点击 Install。
3. 按提示输入 RecurPost 邮箱和 API Password Key。密钥会存储在操作系统的钥匙串中，而不是纯文本文件里。

RecurPost 工具会立即出现在新聊天中。要更新，请下载最新文件并重新安装。

手动设置

以下手动方式需要 Node.js 18 或更高版本。如果在终端中运行 node -v 未显示版本号，请从 https://nodejs.org 下载 LTS 安装程序。

macOS 上的 Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "recurpost": {
      "command": "npx",
      "args": ["-y", "recurpost-mcp"],
      "env": {
        "RECURPOST_EMAIL": "[email protected]",
        "RECURPOST_API_KEY": "your-api-key"
      }
    }
  }
}

完全退出 Claude Desktop（按 Cmd+Q，而不只是关闭窗口），然后重新打开。

Windows 上的 Claude Desktop

在 Windows 上不要使用 npx。Windows 没有 npx 可执行文件（只有 Claude Desktop 无法启动的 npx.cmd）；即使通过 cmd /c 运行，首次下载软件包通常也会超过 60 秒的握手时限，因此服务会显示为“正在运行”，但每次调用都会失败。

安装一次软件包，然后让 Claude Desktop 直接指向它：

1. 打开命令提示符并运行：

   npm install -g recurpost-mcp
   

2. 找到安装位置。以下命令会显示全局文件夹：

   npm root -g
   

   通常是 C:\Users\YOUR-USERNAME\AppData\Roaming\npm\node_modules。

3. 先完全退出 Claude Desktop。 仅关闭窗口还不够：右键点击系统托盘中的 Claude 图标并选择 Quit，或在任务管理器中结束所有 Claude.exe 进程。应用退出时会重写其配置文件，并丢弃运行期间所做的修改。

4. 打开 %APPDATA%\Claude\claude_desktop_config.json，使用第 2 步中的文件夹，并严格按示例添加双反斜杠：

   {
     "mcpServers": {
       "recurpost": {
         "command": "C:\\Program Files\\nodejs\\node.exe",
         "args": [
           "C:\\Users\\YOUR-USERNAME\\AppData\\Roaming\\npm\\node_modules\\recurpost-mcp\\build\\index.js"
         ],
         "env": {
           "RECURPOST_EMAIL": "[email protected]",
           "RECURPOST_API_KEY": "your-api-key"
         }
       }
     }
   }
   

   如果使用记事本保存，请将 Save as type 设为 All Files（否则会自动添加 .txt），并将 Encoding 设为 UTF-8，而不是 UTF-8 with BOM。

5. 启动 Claude Desktop。几秒钟内即可看到这些工具。

macOS / Linux 上的 Claude Code

claude mcp add recurpost --scope user \
  -e [email protected] \
  -e RECURPOST_API_KEY=your-api-key \
  -- npx -y recurpost-mcp

Windows 上的 Claude Code

使用一行命令（上面的反斜杠换行仅适用于 bash）。运行 npm install -g recurpost-mcp 后：

claude mcp add recurpost --scope user -e [email protected] -e RECURPOST_API_KEY=your-api-key -- "C:\Program Files\nodejs\node.exe" "C:\Users\YOUR-USERNAME\AppData\Roaming\npm\node_modules\recurpost-mcp\build\index.js"

在所有平台上，-e 标志必须放在 -- 之前。-- 后的所有内容都会传给服务命令，因此服务启动时将没有凭据。--scope user 会让服务在每个项目中都可用；省略此参数则只会将其添加到当前项目。

3. 验证

询问：“Verify my RecurPost connection”（运行 user_login），然后询问 “Show me all my connected social accounts”。

故障排除

Claude Desktop 会为每个服务写入一个日志文件：

• macOS：~/Library/Logs/Claude/mcp-server-recurpost.log
• Windows：%APPDATA%\Claude\logs\mcp-server-recurpost.log

你看到的情况	原因	解决方法
Settings > Developer 下完全没有列出服务，也没有日志文件	配置从未读取：保存成了 .json.txt、保存时带有 BOM，或应用退出时覆盖了配置	重新保存为 所有文件 / UTF-8；编辑前完全退出 Claude
日志显示 spawn npx ENOENT	Windows 无法启动 npx	使用上面的 Windows 配置（node.exe + 完整路径）
服务显示正在运行，日志在 initialize 后约 60 秒显示 Request timed out，每次调用都失败	npx 耗时超过握手时限	采用相同的解决方法：全局安装，直接使用 node.exe 启动
工具结果显示 Could not reach https://social.recurpost.com ... [ENOTFOUND] 或 [ECONNREFUSED]	启动的进程无法正常访问网络	检查 VPN/代理/防病毒软件；如果在终端中运行 node -e "fetch('https://social.recurpost.com')" 可以正常工作，但从 Claude 调用时不行，则说明应用正在沙盒化其子进程
Error: RECURPOST_EMAIL and RECURPOST_API_KEY environment variables are required.	env 中没有凭据（或在 Claude Code 中把凭据放在了 -- 之后）	将它们移到 env 区块中 / -- 之前

可用工具

工具	描述
user_login	验证你的 API 凭据
workspace_list	列出你所属的所有工作区（自有和共享）
social_account_list	列出所有已连接的社交媒体账号
library_list	列出所有内容库
connect_social_account_urls	获取连接新社交账号的网址
history_data	获取某个社交账号的发布历史
post_content	向社交账号发布或安排内容
add_content_in_library	将内容添加到内容库，以便定期发布
generate_content_with_ai	使用 AI 生成社交媒体帖子文本
generate_image_with_ai	根据文本描述生成图像

工作区

social_account_list、library_list、history_data、post_content 和 add_content_in_library 可接受可选参数 workspace_id（来自 workspace_list 的 ws_id）。省略时，将使用你的默认工作区。提供该参数时，结果和操作将限定在该工作区内——社交账号和内容库必须属于该工作区。

示例提示词

• “显示我所有已连接的社交账号”
• “明天上午 9 点在我的 Facebook 公共主页发布一篇关于夏季促销的帖子”
• “生成一篇关于远程工作效率技巧的 LinkedIn 帖子”
• “本周我的 Twitter 账号发布了哪些帖子？”
• “将 5 条关于社交媒体营销的常青技巧添加到我的 Tips 内容库”
• “列出我的工作区，然后显示 Client A 工作区中的社交账号”

安全

• 你的凭据存储在本地配置中，绝不会离开你的设备，但会直接用于向 RecurPost API 进行身份验证
• 服务作为子进程在本地运行，不涉及外部服务
• API 密钥和电子邮件通过环境变量传递，绝不会暴露给 AI 模型

许可证

MIT