Youtube Transcript Mcp

YouTube Transcript MCP 服务

YouTubeTranscript.dev 的 MCP 服务 — 提取字幕、管理历史记录，并利用 YouTube 内容为 AI 助手提供支持。

网站 • 托管 MCP • API 文档 • 定价 • 快速入门 • 工具

---

为什么选择此 MCP 服务？

将 Claude、Cursor、Windsurf 或任何 MCP 客户端连接到 YouTubeTranscript.dev — 无需编写自定义代码。您的 AI 助手可以使用各种工具来提取字幕、查看历史记录，并大规模管理内容。

• ⚡ 快速提取字幕 — 手动字幕或自动字幕，几秒内即可返回
• 📚 字幕历史记录 — 列出、搜索字幕并翻阅分页内容
• 🎯 全面掌控 — 获取统计信息、删除字幕、按视频 ID 获取字幕
• 🔌 一份配置 — 适用于 Claude、Cursor、Windsurf、VS Code、Cline
• 🔒 用户自有密钥 — 每个连接使用独立的 API 密钥，服务器端不存储密钥

→ 获取免费的 API 密钥

---

快速开始

远程 MCP URL：https://mcp.youtubetranscript.dev

Claude、Cursor 和 VS Code 可以将此地址添加为远程 MCP 连接器。ChatGPT 用户必须启用开发者模式，并使用此 URL 创建自定义应用；是否可用取决于工作区套餐。支持 OAuth 的客户端只需登录一次，因此无需在聊天中提供 API 密钥。

客户端	一键操作
Claude	添加自定义连接器
ChatGPT	开发者模式 / 自定义 MCP 应用设置 或 自定义 GPT
Cursor	安装
VS Code	安装
Claude Code	claude mcp add --transport http youtubetranscript https://mcp.youtubetranscript.dev
Grok	grok mcp add --transport http youtubetranscript https://mcp.youtubetranscript.dev

完整操作指南：youtubetranscript.dev/resources/mcp-server

使用 API 密钥的客户端（如果工具不支持 OAuth）：发送 Authorization: Bearer YOUR_API_KEY。x-api-token 仍然有效。请从账户页面获取密钥。

本地运行（可选）： npm install && npm run build && npm run start:http — 然后连接到 http://localhost:8080。

---

MCP 连接设置

Claude Code

claude mcp add --transport http youtubetranscript https://mcp.youtubetranscript.dev

Claude Desktop

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

{
  "mcpServers": {
    "youtubetranscript": {
      "url": "https://mcp.youtubetranscript.dev",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "youtubetranscript": {
      "url": "https://mcp.youtubetranscript.dev",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "youtubetranscript": {
      "serverUrl": "https://mcp.youtubetranscript.dev",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code + Copilot

settings.json：

{
  "mcp": {
    "servers": {
      "youtubetranscript": {
        "url": "https://mcp.youtubetranscript.dev",
        "headers": { "Authorization": "Bearer YOUR_API_KEY" }
      }
    }
  }
}

Cline

将以下内容添加到 Cline MCP 配置中（格式可能因 Cline 版本而异）：

{
  "youtubetranscript": {
    "url": "https://mcp.youtubetranscript.dev",
    "headers": { "Authorization": "Bearer YOUR_API_KEY" }
  }
}

---

将 YOUR_API_KEY 替换为从 youtubetranscript.dev/dashboard/account 获取的 API 密钥。

---

配置

服务端环境（用于部署）

变量	描述	默认值
YTSM_BASE_URL	API 的基础 URL	https://www.youtubetranscript.dev
MCP_PUBLIC_URL	MCP 公共源站	https://mcp.youtubetranscript.dev
YTSM_TIMEOUT_MS	请求超时时间（毫秒）	30000
PORT	HTTP 服务端口	8080
DEBUG	启用调试日志	false（设为 true 以启用）

注意： HTTP 模式会在客户端支持时使用 OAuth，包括兼容的 Claude、Cursor、VS Code 和 Grok 客户端。ChatGPT 需要启用开发者模式并创建自定义 MCP 应用。使用 API 密钥的客户端可以通过客户端发送 Authorization: Bearer / x-api-token。请勿将用户密钥放入服务端环境变量中。对于 stdio 模式，请设置 YTSM_API_KEY。始终将 YTSM_BASE_URL 设为 https://www.youtubetranscript.dev — 顶级域名主机返回 301 重定向，会导致 POST/身份验证失败。

---

工具参考

工具	最适合用于	返回内容
get_stats	积分、字幕稿数量、套餐	credits、transcripts_total、plan、rate_limit
transcribe_v2	创建／获取字幕稿（快速）	字幕稿 JSON
list_transcripts	列出用户的字幕稿	带分页的历史记录列表
get_transcript	根据 video_id 获取完整字幕稿	字幕稿详情
delete_transcript	删除字幕稿	删除结果

get_stats

剩余积分、已创建的字幕稿、套餐、速率限制。无需参数。

transcribe_v2

基于字幕的快速字幕稿（不使用 ASR）。仅使用手动或自动字幕。

参数	必填	描述
video	是	YouTube URL 或 11 个字符的视频 ID
language	否	语言标签（例如 en、en-US）
source	否	auto（默认）或 manual
format	否	{ timestamp, paragraphs, words } 布尔值

list_transcripts

列出已通过身份验证的用户的字幕稿历史记录。

参数	必填	描述
search	否	按视频 ID、标题或字幕稿文本搜索
limit	否	返回数量（默认值为 10）
page	否	页码（默认值为 1）
status	否	all、queued、processing、succeeded、failed
language	否	语言筛选条件（例如 en）
include_segments	否	在响应中包含字幕稿片段

get_transcript

根据 video_id 获取完整字幕稿。

参数	必填	描述
video_id	是	YouTube 视频 ID
id	否	特定版本的字幕稿记录 ID
language	否	语言筛选条件
source	否	auto、manual 或 asr
include_timestamps	否	在响应中包含时间戳

delete_transcript

删除字幕稿记录。

参数	必填	描述
ids	否*	要删除的字幕稿记录 ID 数组
video_id	否*	便捷方式：按视频 ID 删除（解析出记录 ID）

*至少提供 ids 或 video_id 之一。

---

部署（可选）

用于生产环境时，请部署到支持长连接的服务（例如 Cloud Run、Railway、Fly.io）。对于 MCP，请避免使用无服务器平台（Vercel、Lambda），因为超时和并发限制会导致问题。

docker build -f Dockerfile.cloudrun -t gcr.io/YOUR_PROJECT/youtube-transcript-mcp .
docker push gcr.io/YOUR_PROJECT/youtube-transcript-mcp
gcloud run deploy youtube-transcript-mcp --image gcr.io/YOUR_PROJECT/youtube-transcript-mcp ...

---

Stdio（替代方式）

作为子进程运行，而非通过 HTTP 运行。**必需：**在环境变量中设置 YTSM_API_KEY（stdio 不会在每个请求中传递 API 密钥）。

{
  "mcpServers": {
    "youtubetranscript": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": { "YTSM_API_KEY": "YOUR_API_KEY" }
    }
  }
}

在运行 npm run build 后，从项目目录运行。对于全局安装的软件包，请使用该软件包中的 dist/index.js 路径。

---

开发

npm install
npm run build
npm test
npm run start:http   # Local HTTP server (port 8080)

快速测试所有工具（需要在环境变量中设置 YTSM_API_KEY）：

npm install && npm run build
export YTSM_API_KEY=your_key   # bash/mac
$env:YTSM_API_KEY="your_key"   # PowerShell
npm run test:all

完整测试说明请参阅 QUICK_TEST.md。

---

Links

• 🌐 YouTubeTranscript.dev
• 🔌 Hosted MCP
• 📖 API Documentation
• 💰 Pricing

---

License

MIT License — see LICENSE for details.