跳到内容

面向 AI 代理的 MCP

MCP 为 AI 客户端提供 VibeVO 工具,可查询账号、活动和帖子,管理内容工厂并制作报告。

连接客户端

需要 Node.js 20+ 和 VibeVO API 密钥。查询需要 read 权限;修改需要 write 及相应功能的访问权限。 创建 API 密钥.

只将密钥保存在私人配置或 VIBEVO_API_KEY 环境变量中。不要发到聊天或提交到仓库。所有操作均影响真实数据。

客户端配置

Codex · CLI / IDE

将此配置添加到 ~/.codex/config.toml。在启动 Codex 的环境中设置 VIBEVO_API_KEY。适用于 CLI 和 IDE 扩展。重启客户端后用 /mcp 检查连接。

~/.codex/config.toml
[mcp_servers.vibevo]
command = "npx"
args = ["-y", "@vibevo/mcp@latest"]
env_vars = ["VIBEVO_API_KEY"]
客户端文档 · Codex
Claude Desktop / Cursor

Claude Desktop:Settings → Developer → Edit Config。Cursor:个人配置 ~/.cursor/mcp.json。合并到已有配置,仅在本地替换 REPLACE_WITH_YOUR_API_KEY,然后重启客户端。

claude_desktop_config.json / ~/.cursor/mcp.json
{
  "mcpServers": {
    "vibevo": {
      "command": "npx",
      "args": [
        "-y",
        "@vibevo/mcp@latest"
      ],
      "env": {
        "VIBEVO_API_KEY": "REPLACE_WITH_YOUR_API_KEY"
      }
    }
  }
}

Windows 找不到 npx 时,使用 command: cmd 和 args: ["/c", "npx", "-y", "@vibevo/mcp@latest"]。

客户端文档 · Claude Desktop客户端文档 · Cursor

验证连接

请代理调用 vibevo_whoami,确认密钥所有者与权限。401 表示需检查密钥;403 表示需检查权限和功能访问。

功能与工具

工具可用性取决于已发布版本、角色和密钥权限。准确参数以连接的服务器提供的结构为准。

身份与钱包

工具列表 3
  • vibevo_whoami读取
  • vibevo_get_wallet读取
  • vibevo_list_wallet_transactions读取

社交账号与验证

工具列表 10
  • vibevo_list_social_accounts读取
  • vibevo_get_social_account_verification读取
  • vibevo_get_social_account_stats读取
  • vibevo_add_social_account写入
  • vibevo_connect_social_account写入
  • vibevo_start_social_account_verification写入
  • vibevo_check_social_account_verification写入
  • vibevo_start_social_account_stats_session写入
  • vibevo_upload_social_account_stats写入
  • vibevo_refresh_social_account_stats写入

活动与帖子

工具列表 14
  • vibevo_list_offers读取
  • vibevo_list_my_posts读取
  • vibevo_list_campaigns读取
  • vibevo_get_campaign读取
  • vibevo_get_campaign_analytics读取
  • vibevo_list_campaign_posts读取
  • vibevo_list_campaign_creators读取
  • vibevo_list_campaign_tracking_links读取
  • vibevo_list_campaign_post_proofs读取
  • vibevo_get_campaign_post_proof读取
  • vibevo_download_campaign_proofs_zip读取
  • vibevo_list_my_post_proofs读取
  • vibevo_get_my_post_proof读取
  • vibevo_submit_post写入

工厂、账号与标签

工具列表 11
  • vibevo_list_factories读取
  • vibevo_get_factory_summary读取
  • vibevo_list_factory_accounts读取
  • vibevo_list_factory_posts读取
  • vibevo_get_factory_account读取
  • vibevo_create_factory写入
  • vibevo_patch_factory写入
  • vibevo_add_factory_items写入
  • vibevo_patch_factory_account写入
  • vibevo_list_factory_tags读取
  • vibevo_list_factory_tag_groups读取

为账号添加标签

标签分配给工厂中的监控账号,可用于筛选账号、帖子和统计汇总。你的标签列表跨工厂共用。

  1. 用 vibevo_list_factories 查找工厂,再用 vibevo_list_factory_accounts 查找账号。使用返回的 factoryAccountId,而非社交平台 ID。
  2. 读取现有 tags,将新旧标签去重合并,再把完整列表传给 vibevo_patch_factory_account。
  3. 重新读取账号验证结果。vibevo_list_factory_tags 列出可用标签;vibevo_list_factory_tag_groups 返回工厂的标签汇总。

用于添加标签并保留现有标签的请求。发送前请替换工厂名称、账号和标签。

参数示例 · 请替换 ID 和标签
vibevo_patch_factory_account
{
  "id": 1,
  "factoryAccountId": 42,
  "tags": [
    "Brand",
    "Autumn"
  ]
}
tags 会替换完整列表;[] 会删除账号所有标签。最多 20 个,每个 1–64 字符。新账号可通过 vibevo_add_factory_items 的 tags 设置;无需重复添加已有账号。

监控与代币

工具列表 9
  • vibevo_refresh_factory_account写入
  • vibevo_get_monitoring_wallet读取
  • vibevo_get_factory_credits读取
  • vibevo_get_factory_credit_usage读取
  • vibevo_list_factory_credit_history读取
  • vibevo_update_factory_scan_settings写入
  • vibevo_set_factory_monitoring写入
  • vibevo_refresh_factory_post写入
  • vibevo_buy_monitoring_tokens写入

公开报告

工具列表 5
  • vibevo_list_factory_reports读取
  • vibevo_create_factory_report写入
  • vibevo_revoke_factory_report写入
  • vibevo_restore_factory_report写入
  • vibevo_delete_factory_report写入

ER 与收藏数

ER = 100 × (likes + comments) / views,保留两位小数。使用观看、点赞、评论的最新完整观测。汇总按计数之和计算,不对各帖百分比求平均。观看数为零或没有完整观测时,ER 为 null。收藏和转发不计入公式。

活动列表、详情、分析、帖子和创作者返回 engagement,scope 为 accepted_video。仅包含已接受的视频帖子;帖子行只涵盖该帖子,创作者行涵盖其账号。分母使用 engagement.views:原有 totalViews 可能包含其他状态或表示付费观看数。

内容工厂的标准 ER 位于 metrics.er(汇总为 totals.er),收藏数位于 metrics.saves。历史点和 snapshotBaseline 具有相同字段。原有顶层 er 保留旧语义,新客户端使用嵌套字段。旧响应缺少新字段不代表已测量。

saves 是独立的最新已知计数。自动来源为 TikTok collectCount 和 X bookmarkCount,仅在提供方返回有效值时使用。其他平台没有实际测量时不可用。0 表示测得零,null 表示没有数据,不能将 null 替换为零。旧活动历史无法证明原始观看数;新 ER 随正常扫描逐步可用,无需批量付费重扫。

erCoverage 和 savesCoverage 中的 measuredPosts / totalPosts 涵盖分页前的整个筛选集合。部分覆盖表示部分汇总。updatedAt 和 savesUpdatedAt 是已包含测量中最早的时间;null 表示新鲜度未知。把旧计数带入新快照不会更新时间。图表的 ER 与收藏数为绝对快照,不使用增量模式。

报告 hiddenFields 支持 saves:服务端会移除计数、覆盖率和测量时间。隐藏 views、likes、comments 或 er 也会移除相关 ER;posts 隐藏覆盖率,lastScanned 隐藏测量时间。规则适用于汇总、行、历史和基准值。

{
  "engagement": {
    "scope": "accepted_video",
    "views": 100,
    "likes": 0,
    "comments": 0,
    "er": 0,
    "saves": null,
    "erCoverage": { "measuredPosts": 1, "totalPosts": 2 },
    "savesCoverage": { "measuredPosts": 0, "totalPosts": 2 },
    "updatedAt": "2026-10-09T08:00:00.000Z",
    "savesUpdatedAt": null
  }
}

更新 MCP

@latest 使用 npm 已发布版本,而非 GitHub 分支。若固定了旧版本,改为 @latest,然后停止并重启 MCP 服务或完整重启 AI 客户端。网站更新不会更新正在运行的 MCP 进程。

查看最新已发布版本:
npm view @vibevo/mcp version

重启后刷新客户端工具列表。标签功能需要 vibevo_list_factory_tags 及 vibevo_patch_factory_account 的 tags 参数(自 0.3.0 起支持)。npm 更新无法获得尚未发布的工具。

代理提示词

连接 MCP 后复制并发送给代理。包含文档、npm 链接及数据操作规则。

MCP 與創作者目錄
MCP 保留現有 100 個工具;不新增頭像工具。手動建立頻道可傳入安全的公開 canonicalUrl(Twitch/Kick 仍支援舊有的 handle-only 格式)。相容欄位 publishAfterApproval 為 true 時立即發布目前版本,為 false 時僅保留私人預覽。已發布的 0.7.0 套件不會重寫;新欄位是否可用及套件版本由獨立發佈確認。目錄與已發布頁面仍可匿名讀取;其他參與者操作需要 API 金鑰、scope、角色與物件權限。JWT 頭像更新路徑無法透過 MCP 使用。工具不會以文字傳送完整檔案,也不會公開私人財務欄位。 查看端點參考

这篇文章有帮助吗?

更新日期: 2026-09-23

面向 AI 代理的 MCP · VibeVO | VibeVO Docs