YouTube转录服务器

一个用于获取YouTube视频转录文本的MCP服务器,支持多语言和分页功能。

作者 By jkawamoto
本地部署 可托管 视频转录
GitHub

YouTube转录MCP服务器

此MCP服务器检索给定YouTube视频URL的转录。

YouTube Transcript Server MCP server

工具

此MCP服务器提供以下工具:

get_transcript

获取指定YouTube视频的文字记录。

参数

  • 网址 (字符串):YouTube视频的完整URL。此字段必填。
  • 语言 (字符串,可选):成绩单所需的语言。默认为 en 如果没有指定。
  • next_cursor (字符串,可选):光标用于检索成绩单的下一页。

get_timed_transcript

获取带有时间戳的指定YouTube视频的转录。

参数

  • 网址 (字符串):YouTube视频的完整URL。此字段必填。
  • 语言 (字符串,可选):成绩单所需的语言。默认为 en 如果没有指定。
  • next_cursor (字符串,可选):光标用于检索成绩单的下一页。

get_video_info

获取指定YouTube视频的元数据。

参数

  • 网址 (字符串):YouTube视频的完整URL。此字段必填。

get_available_languages

检索视频的可用语言。

参数

  • 网址 (字符串):YouTube视频的完整URL。此字段必填。

安装

[!注意] 你需要 uv 安装在您的系统上以供使用 uvx 命令。

对于

有关详细的安装说明,请参阅本教程: YouTube转录扩展.

对于 克劳德

下载最新的MCP捆绑包 mcp-youtube-transcript.mcpb 从 这 发布 页面, 然后打开下载的 .mcpb 文件或将其拖动到Claude Desktop的“设置”窗口中。

Manually configuration 您还可以为Claude Desktop手动配置此服务器。 编辑 claude_desktop_config.json 通过在下面添加以下条目来创建文件 mcpServers:

JSON``` 1 2 3 4 5 6 7 8 9 10 11 12{ “mcpServers”: { “youtube-transcript”: { “command”: “uvx”, “args”: [ “—from”, “git+https://github.com/jkawamoto/mcp-youtube-transcript”, “mcp-youtube-transcript” ] } } }


编辑后,重新启动应用程序。



欲了解更多信息,
参见: [连接到本地MCP服务器-模型上下文协议。](https://modelcontextprotocol.io/docs/develop/connect-local-servers).


### 对于 [LM 工作室](https://lmstudio.ai/)


要为LM Studio配置此服务器,请单击下面的按钮。


[![](https://files.lmstudio.ai/deeplink/mcp-install-light.svg)](https://lmstudio.ai/install-mcp?name=youtube-transcript&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL2prYXdhbW90by9tY3AteW91dHViZS10cmFuc2NyaXB0IiwibWNwLXlvdXR1YmUtdHJhbnNjcmlwdCJdfQ%3D%3D)


### 使用Docker


此服务器的Docker镜像可在 [Docker 中心](https://hub.docker.com/mcp/server/youtube_transcript/).
请参阅Docker Hub页面以获取详细的使用说明和文档。


## 响应分页


检索较长视频的转录时,内容可能会超过LLM的令牌大小限制。
为了避免此问题,此服务器拆分超过50000个字符的转录。
如果成绩单被拆分,回复将包括 `next_cursor`.
要检索下一部分,请包含以下内容 `next_cursor` 您的请求很有价值。


令牌大小限制因您使用的LLM和语言而异。
如果你需要将响应分成更小的块,
您可以使用 `--response-limit` 命令行参数。
例如,下面的配置将响应拆分为每个不超过15000个字符:


JSON```
1
2
3
4
5
6
7
8
9
10
11
12
13
14{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript",
        "--response-limit",
        "15000"
      ]
    }
  }
}

使用代理服务器

在限制访问YouTube的环境中,您可以使用代理服务器。

使用时 网上共享,使用以下任一方式设置住宅代理的用户名和密码 环境变量 WEBSHARE_PROXY_USERNAMEWEBSHARE_PROXY_PASSWORD, 或命令行参数 --webshare-proxy-username--webshare-proxy-password.

使用其他代理服务器时,使用环境变量设置代理服务器URL HTTP_PROXYHTTPS_PROXY,或命令行参数 --http-proxy--https-proxy.

如需了解更多详情,请访问: 处理IP禁令-YouTube转录API.

许可证

此应用程序根据MIT许可证获得许可。请参阅 许可证 文件以获取更多详细信息。