⚙

YouTube字幕提取服务器

一个通过简单接口提供YouTube视频字幕和字幕提取功能的Model Context Protocol服务器。

作者 By kimtaeyoon83
本地部署 字幕提取 YouTube工具
GitHub

YouTube转录服务器

一个模型上下文协议服务器，可以从YouTube视频中检索转录本。该服务器通过一个简单的界面提供对视频字幕和字幕的直接访问。

mcp-server-youtube-transcript MCP server

通过Smithery安装

通过以下方式自动安装克劳德桌面版YouTube转录服务器 铁匠铺:

BASH``` 1npx -y @smithery/cli install @kimtaeyoon83/mcp-server-youtube-transcript —client claude


## 组件


### 工具


- **get_transcript**

- 从YouTube视频中提取文字记录
- 输入：

- `url` （字符串，必填）：YouTube视频URL、短片URL或视频ID
- `lang` （string，可选，默认值：“en”）：成绩单的语言代码（例如，‘ko’，‘en’）。如果找不到请求的语言，则自动回退到可用语言。
- `include_timestamps` （布尔值，可选，默认值：false）：在输出中包含时间戳（例如，“[0:05]文本”）
- `strip_ads` （布尔值，可选，默认值：true）：根据章节标记从成绩单中筛选出赞助、广告和促销内容


## 主要特点


- 支持多种视频URL格式（包括YouTube短片）
- 具有自动回退功能的特定语言转录检索
- 用于引用特定时刻的可选时间戳
- 内置广告/赞助过滤（默认启用）
- 转录获取无外部依赖
- 响应中的详细元数据


## 配置


要与Claude Desktop一起使用，请添加以下服务器配置：


JSON```
1
2
3
4
5
6
7
8{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
    }
  }
}

通过工具安装

mcp获取 用于安装和管理模型上下文协议（MCP）服务器的命令行工具。

SHELL``` 1npx @michaellatman/mcp-get@latest install @kimtaeyoon83/mcp-server-youtube-transcript


## 很棒的mcp服务器


[很棒的mcp服务器](https://github.com/punkpeye/awesome-mcp-servers) 精心策划的出色模型上下文协议（MCP）服务器列表。


## 发展


### 先决条件


- Node.js 18或更高版本
- npm或纱线


### 设置


安装依赖项：


BASH```
1npm install

构建服务器：

BASH``` 1npm run build


对于自动重建的开发：


BASH```
1npm run watch

测试

BASH``` 1npm test


### 调试


由于MCP服务器通过stdio进行通信，调试可能具有挑战性。我们建议使用MCP Inspector进行开发：


BASH```
1npm run inspector

运行评估

evals包加载一个mcp客户端，然后运行index.ts文件，因此不需要在测试之间重建。您可以通过在npx命令前加前缀来加载环境变量。可以找到完整的文档 这里.

BASH``` 1OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts


## 错误处理


服务器为常见场景实现了强大的错误处理：


- 视频URL或ID无效
- 不可用的成绩单
- 语言可用性问题
- 网络错误


## 使用示例


1. 通过视频URL获取成绩单：


TYPESCRIPT```
1
2
3
4await server.callTool("get_transcript", {
  url: "https://www.youtube.com/watch?v=VIDEO_ID",
  lang: "en"
});
  1. 通过视频ID获取成绩单：

TYPESCRIPT``` 1 2 3 4await server.callTool(“get_transcript”, { url: “VIDEO_ID”, lang: “ko” });


1. 从YouTube短片中获取文字记录：


TYPESCRIPT```
1
2
3await server.callTool("get_transcript", {
  url: "https://www.youtube.com/shorts/VIDEO_ID"
});
  1. 获取带有时间戳的成绩单：

TYPESCRIPT``` 1 2 3 4await server.callTool(“get_transcript”, { url: “VIDEO_ID”, include_timestamps: true });


1. 获取无广告过滤的原始成绩单：


TYPESCRIPT```
1
2
3
4await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  strip_ads: false
});
  1. 如何在Claude桌面应用程序中提取YouTube字幕
1chat: https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB Extract subtitles

安全考虑

服务器：

  • 验证所有输入参数
  • 优雅地处理YouTube API错误
  • 实现转录检索超时
  • 提供详细的错误消息以进行故障排除

许可证

此MCP服务器根据MIT许可证获得许可。有关详细信息，请参阅LICENSE文件。