VidSeeds.ai

VidSeeds.ai MCP 市场和连接器目录

直接通过 AI 编码客户端操控 VidSeeds.ai，完成视频上传前的 SEO 和元数据优化，并将视频发布到多个平台。

VidSeeds.ai 会分析创作者现有的视频，为 YouTube、TikTok、Instagram、Facebook、LinkedIn 和 X 生成经过优化的标题、描述、标签、缩略图和章节，然后发布这些内容。它不是视频生成器或编辑器。

此仓库是托管式 MCP 连接器的公共市场/目录源，该连接器提供 VidSeeds.ai 工作流 （247 个工具，名称均以 vidseeds_ 为前缀）。其中包含不同客户端所需的机器可读元数据：

客户端 / 目录	此仓库提供的内容
Claude Code	.claude-plugin/marketplace.json、.claude-plugin/plugin.json、.mcp.json 和工作流技能
Codex	.agents/plugins/marketplace.json、.codex-plugin/plugin.json、codex.mcp.json 和工作流技能
官方 MCP Registry 和下游目录	根目录下供 mcp-publisher 和兼容 Registry 的爬虫使用的 server.json
ChatGPT	源元数据/素材，以及独立 Apps SDK 端点 https://vidseeds.ai/api/mcp/chatgpt 的文档
Cursor 和其他 MCP 客户端	可复制粘贴的 Streamable HTTP 配置：https://vidseeds.ai/api/mcp

此连接器不提供凭据，而是告知客户端如何使用你提供的令牌调用托管端点。

• 端点： https://vidseeds.ai/api/mcp（MCP Streamable HTTP）
• **身份验证（此插件）：**个人访问令牌（Authorization: Bearer vs_pat_…）
• **身份验证（Claude.ai / Desktop）：**同一端点也支持 OAuth 2.0（PKCE + Dynamic Client Registration）——将其添加为自定义连接器即可，无需令牌。请参阅下方的应用内指南。
• **ChatGPT App：**专用端点 https://vidseeds.ai/api/mcp/chatgpt 为 OpenAI ChatGPT App（Apps SDK）提供支持，并呈现结果小组件。ChatGPT 不具备本地 shell，因此该端点会隐藏仅限本地使用的工具（ffmpeg/ffprobe 配方、精确剪辑、本地音频转录）——如需使用这些工具，请使用此 Claude Code / Codex 插件。ChatGPT 的分发通过 ChatGPT Apps 提交/目录流程进行，不能将此 Git 仓库添加为自定义市场。
• 服务： vidseeds v1.9.2（Agent 导向：优先路由的服务说明，适配客户端截断限制；包含 vidseeds_guide 工具和工作流提示词）

**更多客户端和复制粘贴操作指南：**应用内设置指南 https://vidseeds.ai/settings/mcp-settings 涵盖 Claude.ai 和 Desktop（OAuth）、 Claude Code、Cursor、Codex 以及任何其他 MCP 客户端，并为每个客户端提供可直接复制的 代码片段。 💳 付费连接器——14 天免费试用。 此 MCP 服务面向付费的 VidSeeds.ai 订阅用户。每个账户都可获得 14 天免费试用，从首次 MCP 连接时开始 ——包括此前从未连接过的老账户；试用结束后，必须保持订阅有效才能继续使用此连接器。请前往 https://vidseeds.ai/pricing 管理套餐。

如果你正在编辑 VidSeeds.ai 源代码： 请勿在用于处理此代码仓库的同一个编码 Agent 会话中连接 vidseeds MCP 服务。目录（即使使用 ?toolset=core）也是用于操作用户视频/频道的_产品界面_。 它会占用你完成实际代码修改所需的上下文。请使用 Agent 的常规文件系统 / grep / 编辑工具。仅在专门测试 MCP 层、新工具、路由处理程序等时连接 MCP（建议使用 ?toolset=core）。请参阅根目录 AGENTS.md 中的“上下文卫生”部分。

---

1. 获取个人访问令牌（必需）

1. 在 https://vidseeds.ai 登录（免费账户）。
2. 打开 Settings → MCP Settings：https://vidseeds.ai/settings/mcp-settings。
3. 创建令牌并复制密钥（vs_pat_…）——它仅显示一次 （默认有效期为 90 天）。
4. 将其作为 VIDSEEDS_PAT 环境变量提供给客户端（见下文）。

🔒 令牌值绝不能写入任何文件。此软件包通过名称引用它 （VIDSEEDS_PAT）；客户端会在连接时从环境中注入令牌值。 泄露的 PAT 可授予对账户的完整非管理员访问权限——请像对待密码一样保管它。

ℹ️ 创建令牌免费，但连接需要付费订阅或有效的 14 天试用（见上文）。除了访问权限外，各个工具还会从余额中扣除 种子（只读工具免费）—— 连接权限与每个工具的种子费用相互独立，且每次调用时都由服务端强制执行。

---

2. 在 Claude Code 中安装

选项 A - 安装插件（推荐）

/plugin marketplace add CarrotGamesStudios/vidseeds-mcp
/plugin install vidseeds@vidseeds

然后，在启动 Claude Code 的环境中提供令牌：

export VIDSEEDS_PAT="vs_pat_your_token_here"
claude

运行 /mcp，确认 vidseeds 服务已连接并列出工具。如果看到身份验证错误，说明启动时所在的 shell 未设置 VIDSEEDS_PAT——请导出该变量并重启。

插件的 .mcp.json 会通过 Bearer ${VIDSEEDS_PAT} 注入令牌——这与 Anthropic 官方 GitHub 连接器使用的格式相同。请在启动前设置 VIDSEEDS_PAT； 如果未设置，Claude Code 会将 vidseeds 服务标记为需要配置。

选项 B - 直接添加服务（不使用插件）

适合不安装插件时快速测试。日常使用建议选择选项 A——它会将令牌保存在环境变量（VIDSEEDS_PAT）中，并在运行时读取，而不是将解析后的令牌写入 ~/.claude.json。

请引用环境变量，而不要粘贴原始令牌，这样密钥就不会出现在 shell 历史记录或终端滚屏内容中：

export VIDSEEDS_PAT="vs_pat_your_token_here"
claude mcp add --transport http vidseeds https://vidseeds.ai/api/mcp?toolset=core \
 --header "Authorization: Bearer $VIDSEEDS_PAT"

---

3. 在 Codex 中安装

Codex 目前尚未提供自助式集中插件发布功能，因此最可靠的方式是将服务添加到 Codex 配置中。

选项 A - ~/.codex/config.toml（推荐）

[mcp_servers.vidseeds]
url = "https://vidseeds.ai/api/mcp"
bearer_token_env_var = "VIDSEEDS_PAT"

然后，在 Codex 运行的环境中导出令牌：

export VIDSEEDS_PAT="vs_pat_your_token_here"

选项 B - CLI

codex mcp add vidseeds --url https://vidseeds.ai/api/mcp?toolset=core --bearer-token-env-var VIDSEEDS_PAT

选项 C - 仓库/团队市场

codex plugin marketplace add CarrotGamesStudios/vidseeds-mcp
codex plugin add vidseeds@vidseeds

此仓库还提供了 Codex 仓库市场 .agents/plugins/marketplace.json，以及插件清单 .codex-plugin/plugin.json（MCP 配置位于 codex.mcp.json）。将 Codex 市场指向此仓库，然后使用 codex plugin add 或通过 codex → /plugins 安装 vidseeds。同样适用 VIDSEEDS_PAT 环境变量。

---

4. 在 Cursor 中安装

将服务添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（每个项目）。 Cursor 会解析 url / headers 中的 ${env:…}，因此请通过名称引用令牌，而不是直接粘贴密钥：

{
  "mcpServers": {
    "vidseeds": {
      "url": "https://vidseeds.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:VIDSEEDS_PAT}"
      }
    }
  }
}

在环境中设置 VIDSEEDS_PAT，然后在 Cursor Settings → MCP 中启用 vidseeds 服务。工具名称使用 vidseeds_ 前缀（下划线，而不是点号）。 Cursor 不接受带点号的名称，例如 vidseeds.generate_thumbnail。

---

5. 官方 MCP Registry 和其他目录

根目录中的 server.json 是托管远程服务的兼容 Registry 描述：

• 名称：io.github.CarrotGamesStudios/vidseeds-mcp
• 远程：位于 https://vidseeds.ai/api/mcp 的 streamable-http
• 身份验证标头：必需的机密 Authorization 值，例如 Bearer vs_pat_your_token_here
• 仓库：https://github.com/CarrotGamesStudios/vidseeds-mcp

维护说明：每当连接器版本、端点、身份验证要求或规范描述发生变化时，请使用官方 mcp-publisher CLI 发布或重新发布 server.json。这样，收录官方 Registry 的目录网站就能发现 VidSeeds.ai， 而无需依赖 Claude/Codex 专用插件市场。

---

6. ChatGPT

ChatGPT 不会将此 Git 仓库作为自定义市场安装。请使用 VidSeeds.ai ChatGPT App（待其发布到 ChatGPT Apps 目录后），或使用支持自定义 MCP 连接器的客户端连接托管端点。ChatGPT 端点为 https://vidseeds.ai/api/mcp/chatgpt；它提供适用于 ChatGPT 的工具子集和 渲染后的小组件。

---

7. Agent 技能（工作流指南）

此插件在 skills/ 下附带技能，帮助 Agent 高效使用 MCP，避免猜测工具调用链。在执行成本较高的工作流之前，请先阅读 vidseeds-efficiency。

技能	适用场景
vidseeds-setup	PAT/OAuth、试用、首次连接
vidseeds-efficiency	Seeds、每日 MCP 配额、异步轮询
vidseeds-thumbnails	生成、编辑、工作室、应用到项目
vidseeds-projects	YouTube → 项目 → 元数据
vidseeds-analytics	频道情报、分析、发现
vidseeds-local-video	本地文件、ffmpeg 配方、剪辑
vidseeds-publishing	连接、发布前检查、发布

每个工具的参数和 Seeds 成本来自托管服务的 tools/list 描述。技能讲解的是组合方式，而不是完整目录。维护者同步说明：MAINTAINERS.md。

---

8. 连接器可以做什么

247 个工具覆盖 VidSeeds.ai 创作者工作流的各个环节：

领域	示例
元数据优化	标题、描述、标签、章节；优化历史记录
缩略图	AI 生成、编辑、重新设计；Thumbnail Studio（趋势、简报、主题、叠加文字、风格配置）；发布到 YouTube
项目	从 YouTube 视频创建、快照、应用缩略图、按平台配置
分析与洞察	频道／视频分析、频道洞察、视频剖析、异常检测、公开频道审计
发现与研究	关键词研究、热门视频、快速增长的频道、视频创意
自动剪辑	列出／获取已保存的短视频、编辑元数据、字幕样式、重新取景、下载
翻译与字幕	元数据本地化（85 种语言）、上传／获取／删除字幕
本地视频媒体	probe、帧／片段提取、精确裁剪与插播广告分析（命令在本地运行）
发布	平台连接、安排／确认发布、直接上传到 YouTube
账户	seed 余额、订阅、推荐、支持

Seeds： 部分工具（缩略图生成、AI 洞察、翻译等）会消耗 VidSeeds.ai 余额中的 seeds。只读工具免费。每个工具的描述都会说明其费用；如不确定，请查看 vidseeds_get_seed_balance。

---

9. 工具目录大小管理

247 个工具数量不少。 VidSeeds.ai 连接到 MCP 客户端后，完整工具 目录（约 46K 个令牌）会加载到 Agent 的上下文中。如果 Agent 感觉运行缓慢或 不堪重负，可以切换到更精简的工具集：

9a. 在 MCP URL 中使用 ?toolset=core

添加 ?toolset=guide 可使用最精简配置（仅包含方向指引工具 vidseeds_guide 和说明，约 1 个工具）。 添加 ?toolset=core 可将工具数量从约 247 个减少到约 74 个核心工具（约 16K 个令牌）——推荐作为大多数使用场景的默认配置：

Claude Code（大多数场景推荐）：

claude mcp add --transport http vidseeds https://vidseeds.ai/api/mcp?toolset=core \
 --header "Authorization: Bearer $VIDSEEDS_PAT"

超轻量版（仅 guide）：

claude mcp add --transport http vidseeds https://vidseeds.ai/api/mcp?toolset=guide \
 --header "Authorization: Bearer $VIDSEEDS_PAT"

Cursor（推荐默认配置）：

{
  "mcpServers": {
    "vidseeds": {
      "url": "https://vidseeds.ai/api/mcp?toolset=core",
      "headers": {
        "Authorization": "Bearer ${env:VIDSEEDS_PAT}"
      }
    }
  }
}

（使用 ?toolset=guide 可获得最轻量的配置。）

Codex（推荐）：

[mcp_servers.vidseeds]
url = "https://vidseeds.ai/api/mcp?toolset=core"
bearer_token_env_var = "VIDSEEDS_PAT"

Claude Desktop —— 定义自定义 MCP 连接器时添加：

URL: https://vidseeds.ai/api/mcp?toolset=core

⚠️ 你随时可以切换回完整配置。 如果仅使用 core 工具集的 Agent 需要某个不在 core 工具集中的工具（例如深度洞察、精确裁剪、评论管理），只需从 URL 中移除 ?toolset=core 并重新连接。完整目录始终可用。

在 core 工具集中保留的工具：项目、元数据优化、发布、 缩略图、基础分析、频道管理、翻译、连接、计费 和推荐。其余内容（深度洞察、竞品研究、本地视频 工具、管理、自动剪辑、批量编辑、评论、助手工作流）均不包含在内。

9b. 让 AI 默认使用 VidSeeds.ai 工具

有时，通用型 Agent 会退回到编写原始 Python、ffmpeg 命令模板或浏览器自动化，而不是使用已连接的 VidSeeds.ai 工具。服务端提供了适配这些截断限制的路由优先指令（v1.9.2），不过你也可以直接告知客户端，让路由行为变得确定：

Claude.ai / Claude Desktop - 将以下内容粘贴到 Settings → Profile → Preferences（全局生效）或项目的自定义指令中：

When my request involves my videos, channels, titles, descriptions, tags,
thumbnails, video SEO, keywords, analytics, comments, clips, captions,
translations, scheduling, or publishing, ALWAYS use the connected VidSeeds.ai
tools (vidseeds_*) first - search the available tools for "vidseeds" if none
are loaded. Do not use web search, browser automation, or general knowledge
for these tasks: VidSeeds.ai has authenticated access to my actual channel data,
transcripts, and analytics.

Claude Code - 将相同内容添加到项目的 CLAUDE.md 中（或添加到 ~/.claude/CLAUDE.md，以应用于所有项目）。

Codex / Cursor - 分别将其添加到 AGENTS.md / 项目规则中。

---

平台使用配额（MCP 每日调用配额）

除各工具的种子成本外，每次 MCP 工具调用（读取或写入）都会计入宽裕的每日平台使用配额，并在全天持续补充。这样一来，每种套餐都能轻松应对真实的生产工作负载（每日短视频、调整、轮询、由 Agent 驱动的调查），同时也能对持续的大量抓取或滥用行为收取实际费用。

套餐	每日包含调用次数	配额上限
Sprout	1,000	2,000
Growth	3,000	6,000
Harvest	8,000	16,000
Agency	20,000	40,000
Trial	1,000	1,000

• 持续补充，不会在午夜重置。 配额会按套餐对应的速率补充（例如，Sprout = 1,000 次/天），并累积至上限，因此，使用较少的一天可以为下一天留出合理的突发调用额度。
• 超额费用： 配额用尽后，每次额外的工具调用会消耗 1 个种子（MCP_OVERAGE_SEED_COST），此外还需支付该工具自身的种子成本。配额会持续补充，因此补充后就不会再产生超额费用。
• 余额和费用查询免费且不受配额限制 - vidseeds_get_seed_balance 和 vidseeds_get_seed_balance_and_subscription 永远不会消耗调用次数或产生超额费用。
• 随时查看剩余的免费调用次数：使用 vidseeds_get_seed_balance（它会返回每日补充量、配额上限、可用的免费调用次数和超额费率）。

如果调用超出配额，而你的余额不足以支付 1 个种子的超额费用，工具会返回清晰的 MCP_QUOTA_EXCEEDED 错误，并附上充值链接，不会产生意外扣费。

YouTube 缩略图上传限制

YouTube 对自定义缩略图上传的频率限制与 VidSeeds.ai 种子和 MCP 调用配额分开计算。批量替换缩略图时，建议每个已连接的 YouTube 频道/账号每滚动 24 小时上传不超过约 100 张缩略图。 如果 vidseeds_publish_thumbnail_to_youtube 返回 uploadRateLimitExceeded 或“too many thumbnails recently”，请停止批量操作，保存下一个视频 ID，并稍后继续。

---

安全性

• 此软件包不包含任何凭据。它仅声明 Claude Code / Codex 应如何使用从 VIDSEEDS_PAT 读取的用户提供 PAT 调用 https://vidseeds.ai/api/mcp。
• 切勿提交、粘贴或分享 vs_pat_… 令牌。请前往 https://vidseeds.ai/settings/mcp-settings 轮换或撤销令牌。
• 服务端会按设计拒绝 Cookie/会话身份验证；PAT 是唯一接受的凭据，因此配置错误的客户端无法借用仪表板登录状态。

版本管理

插件版本与 VidSeeds.ai MCP 连接器软件包版本保持一致（当前为 1.9.2 - 路由优先的服务端 instructions 适配了客户端截断限制，让工具搜索客户端默认使用 VidSeeds 工具；此外还包含 vidseeds_guide 工具、vidseeds://guide 资源和工作流提示词）。 通配符 PAT 作用域会自动涵盖服务端新增的工具，因此现有令牌无需重新创建即可继续使用。

链接

• 产品：https://vidseeds.ai
• MCP 设置：https://vidseeds.ai/settings/mcp-settings
• MCP：https://modelcontextprotocol.io

许可证

MIT - 详见 LICENSE。