AI导哈

YouTube字幕下载器

一款轻量级的MCP服务器工具，通过Supadata API获取YouTube视频字幕，适用于AI内容分析、摘要生成等场景。

  • by Milor123
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Milor123/mcp-youtube-transcript-downloader

使用说明

🎬 MCP YouTube转录下载器

将YouTube视频转录直接下载到您的AI工作流程中，无需再复制/粘贴！

一个极简主义的MCP服务器，使用 支持API非常适合需要分析视频内容、创建摘要或提取关键信息的AI助手。

⚡ 特性

  • 🎯 两个方便的工具 — get_transcript 为了快速下载， get_transcript_and_save 用于全路径控制
  • 📦 零依赖 --轻便快速
  • 🔑 灵活的身份验证 --来自文件或环境变量的令牌
  • 🛡️ 基本错误处理 --出错时清除错误消息

🚀 快速开始

先决条件

  • Node.js 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服务器的原创想法！

📜 许可证

麻省理工学院许可证——您可以在项目中自由使用它！

相关 MCP