金大哥 - youtube_transcript

article

README

🚀 YouTube转录MCP服务器

YouTube转录MCP服务器可获取YouTube视频的转录内容。它借助MCP（Model Context Protocol）协议，让Claude等AI模型能轻松利用YouTube视频的字幕数据。

✨ 主要特性

从YouTube视频URL中提取转录内容。
支持多语言转录，如韩语、英语等。
同时支持自动生成和手动生成的字幕。
可查询可用的转录内容列表。

📦 安装指南

1. 克隆仓库

git clone <repository-url>
cd youtube_transcript_mcp

2. 创建并激活虚拟环境

python3 -m venv venv
source venv/bin/activate  # Linux/Mac
# 或者在Windows系统下：venv\Scripts\activate

3. 安装依赖项

pip install -r requirements.txt

📚 详细文档

Claude Desktop配置

若要在Claude Desktop中使用此MCP服务器，需修改Claude配置文件。

macOS系统：Claude Desktop配置文件路径为 ~/Library/Application Support/Claude/claude_desktop_config.json。
Windows系统：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 替换为实际的项目路径。

支持的URL格式

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

支持的语言

韩语 (ko) - 默认值
英语 (en)
其他YouTube支持的所有语言

若请求的语言不可用，服务器将按韩语 → 英语 → 自动生成字幕的顺序尝试获取。

💻 使用示例

在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

🔧 技术细节

API工具

此MCP服务器提供以下两个工具：

1. get_youtube_transcript

说明：获取YouTube视频的转录内容。
参数：
- url（必需）：YouTube视频URL。
- language（可选，默认值："ko"）：语言代码。

2. list_available_transcripts

说明：获取可用的转录内容列表。
参数：
- url（必需）：YouTube视频URL。

问题解决

配置未生效

完全关闭并重新启动Claude Desktop。
确认配置文件路径是否正确。
确认虚拟环境是否已激活。

无法找到转录内容

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

依赖项

mcp>=0.8.0：Model Context Protocol库。
youtube-transcript-api>=0.6.0：YouTube转录API。
asyncio：异步处理。

📄 许可证

本项目遵循MIT许可证进行分发。

youtube_transcript_mcp