MCP YouTube 转录服务器
一个模型上下文协议服务器，支持检索 YouTube 视频的文字记录。该服务器通过简单的界面直接访问视频文字记录，非常适合内容分析和处理。
目录
Related MCP server: YouTube Transcript Server
特征
✨ 主要功能：
从 YouTube 视频中提取文字记录
支持多种语言
使用连续或段落模式格式化文本
检索视频标题和元数据
自动段落分割
文本规范化和 HTML 实体解码
强大的错误处理
时间戳和重叠检测
入门
先决条件
Node.js 18 或更高版本
安装
我们提供两种安装方法：
选项 1：手动配置（推荐用于生产）
创建或编辑 Claude Desktop 配置文件：
macOS：
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows：
%APPDATA%\Claude\claude_desktop_config.json
添加以下配置：
{
"mcpServers": {
"youtube-transcript": {
"command": "npx",
"args": [
"-y",
"@sinco-lab/mcp-youtube-transcript"
]
}
}
}macOS 的快速安装脚本：
# Create directory if it doesn't exist
mkdir -p ~/Library/Application\ Support/Claude
# Create or update config file
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json << 'EOL'
{
"mcpServers": {
"youtube-transcript": {
"command": "npx",
"args": [
"-y",
"@sinco-lab/mcp-youtube-transcript"
]
}
}
}
EOL选项 2：通过 Smithery（仅限开发）
npx -y @smithery/cli install @sinco-lab/mcp-youtube-transcript --client claude⚠️注意：不建议将此方法用于生产，因为它依赖于 Smithery 的代理服务。
用法
基本配置
要与 Claude Desktop / Cursor / cline 一起使用，请确保您的配置匹配：
{
"mcpServers": {
"youtube-transcript": {
"command": "npx",
"args": ["-y", "@sinco-lab/mcp-youtube-transcript"]
}
}
}测试
与克劳德·阿普
安装后重新启动 Claude 应用程序
使用简单命令进行测试：
https://www.youtube.com/watch?v=AJpK3YTTKZ4 Summarize this video
示例输出：
使用 MCP 检查器
# Clone and setup
git clone https://github.com/sinco-lab/mcp-youtube-transcript.git
cd mcp-youtube-transcript
npm install
npm run build
# Launch inspector
npx @modelcontextprotocol/inspector node "dist/index.js"
# Access http://localhost:6274 and try these commands:
# 1. List Tools: clink `List Tools`
# 2. Test get_transcripts with:
# url: "https://www.youtube.com/watch?v=AJpK3YTTKZ4"
# lang: "en" (optional)
# enableParagraphs: false (optional)故障排除和维护
检查克劳德日志
要监控Claude的日志，可以使用以下命令：
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log这将显示日志文件的最后 20 行，并在添加新条目时继续显示它们。
注意：Claude 应用程序会自动为 MCP 服务器日志文件添加
mcp-server-前缀。例如，我们服务器的日志将被写入mcp-server-youtube-transcript.log。
清理npx缓存
如果您遇到与npx缓存相关的问题，您可以使用以下方法手动清理它：
rm -rf ~/.npm/_npx这将删除缓存的包并允许您重新开始。
API 参考
获取成绩单
从 YouTube 视频中获取文字记录。
参数：
url（字符串，必需）：YouTube 视频 URL 或 IDlang（字符串，可选）：语言代码（默认值：“en”）enableParagraphs（布尔值，可选）：启用段落模式（默认值：false）
响应格式：
{
"content": [{
"type": "text",
"text": "Video title and transcript content",
"metadata": {
"videoId": "video_id",
"title": "video_title",
"language": "transcript_language",
"timestamp": "processing_time",
"charCount": "character_count",
"transcriptCount": "number_of_transcripts",
"totalDuration": "total_duration",
"paragraphsEnabled": "paragraph_mode_status"
}
}]
}发展
项目结构
├── src/
│ ├── index.ts # Server entry point
│ ├── youtube.ts # YouTube transcript fetching logic
├── dist/ # Compiled output
└── package.json关键组件
YouTubeTranscriptFetcher：核心成绩单获取功能YouTubeUtils：文本处理和实用程序
特性和功能
错误处理：
无效的 URL/ID
无法获取成绩单
语言可用性
网络错误
速率限制
文本处理：
HTML实体解码
标点规范化
空间规范化
智能段落检测
贡献
欢迎大家贡献！欢迎随时提交问题和拉取请求。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。