VidWords YouTube MCP Server

一个托管的 Model Context Protocol 服务器，让 AI 代理能够阅读 YouTube 视频——并引用它获得答案的确切秒数。

语言模型无法观看视频。将其指向此端点，它就能获得九个工具，用于搜索转录文本、读取视频的帧——幻灯片、图表、演示、屏幕上的文字——并在你看到之前验证引用后回答问题。

无需集成代码。无需抓取。无需代理池。

POST https://vidwords.com/mcp
Authorization: Basic <your-api-token>

仅远程且托管——无需安装或自托管。此仓库是该端点的公开清单、配置参考和问题跟踪器。

快速开始

获取免费令牌：在 vidwords.com/register 创建账户，验证你的电子邮件，然后从你的个人资料中复制令牌。免费计划包含每月积分和 10 个观看分钟，因此你可以在付费之前就完成配置并使用。

Claude Code

claude mcp add --transport http vidwords https://vidwords.com/mcp \
  --header "Authorization: Basic YOUR_API_TOKEN"

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "vidwords": {
      "type": "http",
      "url": "https://vidwords.com/mcp",
      "headers": { "Authorization": "Basic YOUR_API_TOKEN" }
    }
  }
}

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "vidwords": {
      "url": "https://vidwords.com/mcp",
      "headers": { "Authorization": "Basic YOUR_API_TOKEN" }
    }
  }
}

Codex CLI — ~/.codex/config.toml

[mcp_servers.vidwords]
url = "https://vidwords.com/mcp"
env_http_headers = { "Authorization" = "VIDWORDS_MCP_AUTH" }

export VIDWORDS_MCP_AUTH="Basic YOUR_API_TOKEN"

不要使用 bearer_token_env_var。它看起来是明显的字段，但它会发送 Authorization: Bearer <value>，而此服务器使用 Basic 进行身份验证。

claude.ai 和 ChatGPT — OAuth，无需粘贴

将 https://vidwords.com/mcp 添加为自定义连接器。主机自行注册，将你发送到 VidWords 登录，并显示一个同意屏幕，明确说明它请求的内容。仅注册不会授予任何权限——只有已登录的用户点击 批准 后访问才会开始，并且可以从你的 API 页面立即撤销实时连接。

不支持自定义标头的客户端，以及 Docker

此仓库还附带一个小的 stdio 代理（src/index.js），它在 stdin/stdout 上使用 MCP 协议，并将工具调用转发到托管端点。当你的客户端无法发送自定义 HTTP 标头，或者你希望将服务器放在容器中时，请使用它：

{
  "mcpServers": {
    "vidwords": {
      "command": "npx",
      "args": ["-y", "github:haljishi/vidwords-mcp"],
      "env": { "VIDWORDS_API_TOKEN": "YOUR_API_TOKEN" }
    }
  }
}

直接从本仓库运行——该代理未发布到 npm，因此裸 npx @vidwords/mcp 将无法解析。

docker build -t vidwords-mcp .
docker run --rm -i -e VIDWORDS_API_TOKEN=YOUR_API_TOKEN vidwords-mcp

工具模式在代理中内联声明，因此 initialize 和 tools/list 无需任何凭据即可响应，并且在实际调用工具之前不会联系上游。没有 VIDWORDS_API_TOKEN 的调用会返回可读的错误，而不是使握手失败。VIDWORDS_MCP_URL 可覆盖端点，如果你指向非生产实例。

通用的 mcp-remote 桥接器也可以工作：

{
  "mcpServers": {
    "vidwords": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://vidwords.com/mcp",
               "--header", "Authorization:Basic YOUR_API_TOKEN"]
    }
  }
}

现成的配置文件位于 examples/。

Related MCP server: YouTube Transcript MCP Server

九个工具

优先使用 search_transcript 而不是 get_transcript

两者每个视频都花费 1 积分，因此没有计费上的理由来选择。原因是上下文。问“这个两小时的采访关于定价说了什么？”get_transcript 会返回大约 20,000 个单词，其中可能只有 300 个是关于定价的——这 300 个现在要与 19,700 个无关的单词竞争注意力，答案会变得更差、更慢、生成成本更高。

search_transcript 只返回匹配的片段，每个片段都带有深度链接。当你确实想要整个文本时——导出、差异、语料库——才使用 get_transcript。

它读取画面，而不仅仅是字幕

analyze_video 会查看幻灯片、图表、代码示例和从未被说出的屏幕文字。ask_video 然后根据存储的分析进行回答，并且每个引用在你看之前都会被检查：视觉声明必须匹配实际记录的帧，口头声明必须落在真实的转录片段上。任何失败的都会被丢弃，当没有内容幸存时，答案会说明证据不足，而不是产生自信的猜测。

这有时会令人恼火——拒绝比流畅的回答更糟糕的演示——但这是该功能唯一可以安全地放在代理面前的版本，因为代理会重复被告知的内容，而没有人类读者会有的怀疑态度。

认证、费用和限制

• Basic，而不是 Bearer。 令牌按原样发送；你不需要对 user:pass 对进行 base64 编码。

• 首先验证你的电子邮件。 在你点击验证链接之前，每次调用都会返回 403，并带有 {"error":"email_unverified"}——这是新账户最常见的首次调用失败。

• 积分是一个池，与 REST API 和网站共享。一个积分对应一个转录。帧分析改为消耗观看分钟，而在开始前被拒绝的运行不花费任何费用。

• 速率限制：30 个请求 / 10 秒——故意比 REST API 的 5 个更宽松，因为服务器是无状态的，客户端在每次调用前都会重新运行 initialize。analyze_video 有自己的上限，每分钟 10 次启动，与 REST 路由共享。

• 此处拒绝 RapidAPI 令牌。 该身份按调用计费，并且背后没有账户，这两者都无法在工具调用会话中存活。请使用 VidWords API 令牌。

• 设计上无状态。 没有可恢复的 SSE 流，没有要删除的会话；每个工具一次性回答。GET 和 DELETE 返回 JSON-RPC 错误，而不是 HTML 404。

• 字幕必须存在。 对于没有字幕轨道的视频，已登录账户可以改为从音频转录——按长度定价，在你花费之前报价。

完整数字：定价。

文档

• YouTube MCP 服务器 — 概述

• 在 Claude Code 中设置

• 在 Claude Desktop 中设置

• 在 Cursor 中设置

• REST API 文档

支持

在此处针对 MCP 表面的任何问题打开 issue——行为异常的工具、我们未记录配置的客户端、可以更清晰的模式。账户和计费问题请前往 支持。

许可证

本仓库的内容（文档和配置示例）采用 MIT 许可证。托管服务本身是专有的，并受 VidWords 条款 约束。

独立产品；与 YouTube 或 Google 无关。