Postbase

@postbasehq/mcp

适用于 Postbase 的 Model Context Protocol 服务。Postbase 是一款开源社交媒体排程工具。将它添加到 Claude、Cursor 或任何 MCP 客户端，让你的 AI Agent 为 X、LinkedIn、Bluesky 和 Mastodon 起草并排程帖子和串帖。（TikTok 和 YouTube 需要视频，因此请在应用中为它们排程。）

随处发布，甚至可以通过 AI 完成。

托管服务（无需 API 密钥）

Postbase 也会为你运行此服务，地址为 https://mcp.postbase.so/mcp，通过 OAuth 登录，无需 API 密钥。将该 URL 添加为 Claude 或 ChatGPT 中的自定义连接器，或添加为 Cursor、VS Code、Windsurf、Claude Code 或 Gemini CLI 中的远程 MCP 服务。MCP 配置生成器会输出每种工具对应的准确配置。

如果你想改用 API 密钥，或使用可自托管的 Postbase，请使用此 npm 包。

快速开始

1. 在 Postbase 控制面板的 Developers 下创建 API 密钥。
2. 将服务添加到 MCP 客户端配置中（参见下方示例）。
3. 向你的 Agent 提出请求：“将这条串帖排程到 X 和 Bluesky，时间为上午 9 点。”

配置示例

任何 MCP 客户端 — 最简配置：

{
  "mcpServers": {
    "postbase": {
      "command": "npx",
      "args": ["@postbasehq/mcp"],
      "env": { "POSTBASE_API_KEY": "pb_live_your_key_here" }
    }
  }
}

Claude Desktop — 将相同代码块添加到配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

然后重启 Claude Desktop。

Cursor — 将其添加到 ~/.cursor/mcp.json（或通过 Settings → MCP 添加）：

{
  "mcpServers": {
    "postbase": {
      "command": "npx",
      "args": ["@postbasehq/mcp"],
      "env": { "POSTBASE_API_KEY": "pb_live_your_key_here" }
    }
  }
}

本地开发 — 指向在你的机器上运行的 Postbase 实例：

{
  "mcpServers": {
    "postbase": {
      "command": "npx",
      "args": ["@postbasehq/mcp"],
      "env": {
        "POSTBASE_API_KEY": "pb_live_your_key_here",
        "POSTBASE_API_URL": "http://localhost:3000/api/v1"
      }
    }
  }
}

工具

工具	功能
list_channels	列出已连接到你的工作区的频道。
create_post	创建草稿，或排程帖子或 thread：channel_ids、scheduled_at（带偏移量的 ISO 8601 格式）或 schedule_in_minutes、用于设置各频道文本的 channel_bodies、media_ids 或 media_urls、youtube 详情，以及用于确保重试时不会重复发布的 idempotency_key。TikTok 帖子只能保存为草稿。
get_post	查看帖子在各频道的情况：状态、已发布 URL、错误、重试时间和最新指标。
update_post	编辑或重新排程草稿或已排程帖子；只会更改你传入的字段。
retry_post	将帖子重新发送到发布失败的频道。
get_analytics	查看每篇帖子和每个频道的展示次数、点赞、评论、分享和收藏数，以及总计。
list_media	列出 Postbase 媒体库中的图片和视频，以便通过 ID 附加。
add_media	通过公开的 https 链接将图片或视频添加到媒体库。
list_scheduled	列出已排程帖子，或通过 status 列出草稿、已发布或失败的帖子。
cancel_post	根据 ID 取消已排程的帖子（帖子会恢复为草稿）。
schedule_thread	创建串帖（按顺序排列的 tweets）。为兼容旧配置而保留；使用带 thread 的 create_post 效果相同。

环境变量

变量	必填	默认值
POSTBASE_API_KEY	是	—
POSTBASE_API_URL	否	https://www.postbase.so/api/v1

在本地开发时，如果要连接机器上的 Postbase 实例，请设置 POSTBASE_API_URL=http://localhost:3000/api/v1。

许可证

AGPL-3.0-or-later。属于开源 Postbase 项目的一部分。