YouTube Transcript MCP Server

YouTube转录MCP服务器

获取YouTube视频转码的模型上下文协议（MCP）服务器。在Claude等AI模型中，您可以轻松利用YouTube视频的字幕数据。

功能

• 从YouTube视频URL提取转码
• 支持多语言脚本（韩语、英语等）
• 支持自动生成和手动生成字幕
• 查看可用的脚本列表

设置

1. 存储库克隆

   git clone 
   cd youtube_transcript_mcp

1. 创建和激活虚拟环境

   python3 -m venv venv
   source venv/bin/activate  # Linux/Mac
   # 또는 Windows의 경우: venv\Scripts\activate

1. 依赖性安装

   pip install -r requirements.txt

Claude桌面设置

要在Claude Desktop中使用此MCP服务器，必须修改Claude设置文件。

macOS

Claude Desktop配置文件位置： ~/Library/Application Support/Claude/claude_desktop_config.json

视窗

Claude Desktop配置文件位置： %APPDATA%\Claude\claude_desktop_config.json

在配置文件中添加以下内容：

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "/path/to/your/youtube_transcript_mcp/venv/bin/python",
      "args": ["/path/to/your/youtube_transcript_mcp/youtube_transcript_mcp_server.py"],
      "env": {}
    }
  }
}

重要: /path/to/your/youtube_transcript_mcp请将更改为实际项目路径。

使用方法

在Claude Desktop中完成设置后，您可以：

导入脚本

이 YouTube 영상의 트랜스크립트를 가져와줘: https://www.youtube.com/watch?v=VIDEO_ID

将脚本导入为特定语言

이 영상의 영어 트랜스크립트를 가져와줘: https://www.youtube.com/watch?v=VIDEO_ID

查看可用的脚本列表

이 영상에서 사용 가능한 트랜스크립트 목록을 보여줘: https://www.youtube.com/watch?v=VIDEO_ID

支持的URL格式

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• VIDEO_ID （仅11位视频ID）

支持的语言

• 韩语（ko）-默认值
• 英语（en）
• 其他YouTube支持的所有语言

如果没有请求的语言，服务器将自动按韩语→英语→自动生成字幕的顺序进行尝试。

API工具

此MCP服务器提供两种工具：

1.get_youtube_transcript

• 说明：获取YouTube视频的转码
• 参数:

- url （必需）：YouTube视频URL - language （可选，默认值：“ko”）：语言代码

2.list_available_transcripts

• 说明：获取可用脚本列表
• 参数:

- url （必需）：YouTube视频URL

故障排除

如果设置不适用

1. 完全退出Claude Desktop并重新启动
2. 验证配置文件的路径是否正确
3. 验证虚拟环境是否处于活动状态

如果找不到转义脚本

• 该视频可能没有字幕
• 可能是私人视频或访问受限视频
• list_available_transcripts 使用工具查看可用的语言

依赖性

• mcp>=0.8.0：Model Context协议库
• youtube-transcript-api>=0.6.0：YouTube转码API
• asyncio：异步处理

许可证

该项目在MIT许可下分发。