🎬 MCP YouTube转录下载器
将YouTube视频转录直接下载到您的AI工作流程中，无需再复制/粘贴！
](https://www.npmjs.com/package/@milor123/mcp-youtube-transcript-downloader)  ](https://nodejs.org/)
一个极简主义的MCP服务器，使用 支持API非常适合需要分析视频内容、创建摘要或提取关键信息的AI助手。
⚡ 特性
- 🎯 两个方便的工具 —
get_transcript为了快速下载，get_transcript_and_save用于全路径控制 - 📦 零依赖 --轻便快速
- 🔑 灵活的身份验证 --来自文件或环境变量的令牌
- 🛡️ 基本错误处理 --出错时清除错误消息
______________________________________________________________________
🚀 快速开始
先决条件
- 18岁或以上
- 一个免费的Supadata API密钥
安装
# Install dependencies
npm install
# Build the project
npm run build
# Or use directly with npx
npx @milor123/mcp-youtube-transcript-downloader获取您的免费API密钥
注册地址： https://supadata.ai
100个请求/月免费 --无需信用卡！非常适合个人项目和实验。
配置
创建一个 token_api.txt 使用API密钥在项目根目录中创建文件：
sd_your_api_key_here或者设置一个环境变量：
export SUPADATA_API_KEY="sd_your_api_key_here"______________________________________________________________________
📥 可用工具
get_transcript
下载YouTube视频转录并将其保存到 .txt 文件。返回转录内容和文件名，以供后续操作使用。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
youtube_url | string | ✅ | 完整的YouTube视频URL（例如。， https://www.youtube.com/watch?v=dQw4w9WgXcQ) |
filename | string | ❌ | 不带扩展名的自定义文件名。如果省略，则使用视频ID |
退货：
content--完整的成绩单文本_meta.filename--保存成绩单的文件名_meta.videoId--提取的YouTube视频ID
请求示例：
{
"youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"filename": "rick_roll_transcript"
}示例响应：
{
"content": [
{
"type": "text",
"text": "Never gonna give you up, never gonna let you down..."
}
],
"_meta": {
"filename": "rick_roll_transcript.txt",
"videoId": "dQw4w9WgXcQ"
}
}______________________________________________________________________
get_transcript_and_save
下载YouTube视频转录并将其保存到 特定文件路径 由您选择。当您需要精确控制文件的存储位置时，这很好。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
youtube_url | string | ✅ | 完整的YouTube视频URL |
filepath | string | ✅ | 完整文件路径，包括 .txt 扩展（例如。， C:/Users/You/Documents/transcript.txt) |
退货：
- 带有保存成绩单的文件路径的确认消息
请求示例：
{
"youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"filepath": "C:/Users/You/Documents/my_transcripts/rick_roll.txt"
}示例响应：
{
"content": [
{
"type": "text",
"text": "Transcript saved to C:/Users/You/Documents/my_transcripts/rick_roll.txt"
}
]
}💡 提示： 如果父目录不存在，此工具会自动创建父目录！
______________________________________________________________________
🤖 AI客户端配置
开源代码
选项1-远程（推荐-即将推出）
{
"mcpServers": {
"youtube-transcript": {
"type": "remote",
"url": "https://your-remote-mcp-server.com/youtube-transcript",
"environment": {
"SUPADATA_API_KEY": "sd_your_api_key_here"
}
}
}
}远程托管允许多个用户共享单个MCP服务器。联系维护人员访问服务器。
选项2-本地（npx安装）
{
"mcpServers": {
"youtube-transcript": {
"type": "local",
"command": ["npx", "@milor123/mcp-youtube-transcript-downloader"],
"enabled": true,
"environment": {
"SUPADATA_API_KEY": "sd_28bee9cd727665ed7a6ceebcf4c90334"
}
}
}
}克劳德桌面
{
"mcpServers": {
"youtube-transcript": {
"command": "node",
"args": ["/full/path/to/dist/index.js"],
"env": {
"SUPADATA_API_KEY": "sd_your_api_key_here"
}
}
}
}______________________________________________________________________
💰 Supadata免费套餐
| 特征 | 限制 |
|---|---|
| 每月请求数 | 100 |
| 需要信用卡 | ❌ 没有 |
| 成本 | 自由！ |
获取API密钥： https://supadata.ai
______________________________________________________________________
📁 项目结构
@milor123/mcp-youtube-transcript-downloader/
├── src/
│ └── index.ts # Main MCP server implementation
├── dist/ # Compiled JavaScript output (generated after build)
├── token_api.txt # Your API token (never commit this!)
├── package.json
├── tsconfig.json
└── README.md______________________________________________________________________
❤️ 致谢与致谢
这个项目的灵感来自于 穆蒂 从 格里斯福克。感谢您激发了这个MCP服务器的原创想法！
______________________________________________________________________
📜 许可证
麻省理工学院许可证——您可以在项目中自由使用它！