shield_lock
JinDaGe
Contact
← Back to MCP directory
publicPublicdnsLocal runtime

mcp-youtube-transcript

一个通过MCP协议获取YouTube视频字幕的服务器工具

article

README

🚀 MCP YouTube转录服务器

MCP YouTube转录服务器基于模型上下文协议，可从YouTube视频中提取转录内容。通过简单接口，用户能直接访问视频转录，适用于内容分析与处理。

smithery badge

🚀 快速开始

📦 安装指南

npx缓存清理

若遇到与npx缓存相关的问题，可手动清除缓存：

rm -rf ~/.npm/_npx

此操作将删除缓存包，允许从头开始。

💡 参数

  • url（字符串，必需）：YouTube视频URL或ID
  • lang（字符串，可选）：语言代码（默认："en"）
  • enableParagraphs（布尔值，可选）：启用段落模式（默认：false）

🏗️ 项目结构

├── src/
│ ├── index.ts            # 服务器入口点
│ └── youtube.ts          # YouTube转录获取逻辑
└── dist/                 # 编译输出

✨ 主要特性

核心组件

  • YouTubeTranscriptFetcher：核心转录获取功能
  • YouTubeUtils：文本处理和实用工具

🔧 错误处理

  • 无效的URL/ID
  • 转录不可用
  • 语言不可用
  • 网络错误
  • 速率限制

🔍 文本处理

  • HTML实体解码
  • 标点符号规范化
  • 空间规范化
  • 智能段落检测

🤝 贡献指南

我们欢迎贡献！请随时提交问题和拉取请求。

📄 许可证

此项目在MIT许可证下，具体请参见LICENSE文件。

🔗 相关项目

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client