🎬 MCP YouTube转录下载器
> 将YouTube视频转录直接下载到您的AI工作流程中,无需再复制/粘贴!
一个极简主义的MCP服务器,使用 支持API非常适合需要分析视频内容、创建摘要或提取关键信息的AI助手。
⚡ 特性
- 🎯 两个方便的工具 —
get_transcript为了快速下载,get_transcript_and_save用于全路径控制 - 📦 零依赖 --轻便快速
- 🔑 灵活的身份验证 --来自文件或环境变量的令牌
- 🛡️ 基本错误处理 --出错时清除错误消息
🚀 快速开始
先决条件
- Node.js 18岁或以上
- 一个免费的Supadata API密钥
安装```bash
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
或者设置一个环境变量:```bash
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
**请求示例:**```json
{
"youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"filename": "rick_roll_transcript"
}
示例响应:```json
{
"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`) |
**退货:**
- 带有保存成绩单的文件路径的确认消息
**请求示例:**```json
{
"youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"filepath": "C:/Users/You/Documents/my_transcripts/rick_roll.txt"
}
示例响应:```json
{
"content": [
{
"type": "text",
"text": "Transcript saved to C:/Users/You/Documents/my_transcripts/rick_roll.txt"
}
]
}
> 💡 **提示:** 如果父目录不存在,此工具会自动创建父目录!
______________________________________________________________________
## 🤖 AI客户端配置
### 开源代码
#### 选项1-远程(推荐-即将推出)```json
{
"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安装)```json
{
"mcpServers": {
"youtube-transcript": {
"type": "local",
"command": ["npx", "@milor123/mcp-youtube-transcript-downloader"],
"enabled": true,
"environment": {
"SUPADATA_API_KEY": "sd_28bee9cd727665ed7a6ceebcf4c90334"
}
}
}
}
### 克劳德桌面```json
{
"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服务器的原创想法!
📜 许可证
麻省理工学院许可证——您可以在项目中自由使用它!
