MCP YouTube 转录服务器

一个模型上下文协议服务器，支持检索 YouTube 视频的文字记录。该服务器通过简单的界面直接访问视频文字记录，非常适合内容分析和处理。

目录

• 特征

• 入门

  • 先决条件

  • 安装

• 用法

  • 基本配置

  • 测试

  • 故障排除和维护

• API 参考

• 发展

• 贡献

• 执照

特征

✨ 主要功能：

• 从 YouTube 视频中提取文字记录

• 支持多种语言

• 使用连续或段落模式格式化文本

• 检索视频标题和元数据

• 自动段落分割

• 文本规范化和 HTML 实体解码

• 强大的错误处理

• 时间戳和重叠检测

入门

先决条件

• Node.js 18 或更高版本

安装

我们提供两种安装方法：

选项 1：手动配置（推荐用于生产）

1. 创建或编辑 Claude Desktop 配置文件：

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows： %APPDATA%\Claude\claude_desktop_config.json

2. 添加以下配置：

macOS 的快速安装脚本：

选项 2：通过 Smithery（仅限开发）

⚠️注意：不建议将此方法用于生产，因为它依赖于 Smithery 的代理服务。

用法

基本配置

要与 Claude Desktop / Cursor / cline 一起使用，请确保您的配置匹配：

测试

与克劳德·阿普

1. 安装后重新启动 Claude 应用程序

2. 使用简单命令进行测试：

   https://www.youtube.com/watch?v=AJpK3YTTKZ4 Summarize this video

示例输出：

使用 MCP 检查器

故障排除和维护

检查克劳德日志

要监控Claude的日志，可以使用以下命令：

这将显示日志文件的最后 20 行，并在添加新条目时继续显示它们。

注意：Claude 应用程序会自动为 MCP 服务器日志文件添加mcp-server-前缀。例如，我们服务器的日志将被写入mcp-server-youtube-transcript.log 。

清理npx缓存

如果您遇到与npx缓存相关的问题，您可以使用以下方法手动清理它：

这将删除缓存的包并允许您重新开始。

API 参考

获取成绩单

从 YouTube 视频中获取文字记录。

参数：

• url （字符串，必需）：YouTube 视频 URL 或 ID

• lang （字符串，可选）：语言代码（默认值：“en”）

• enableParagraphs （布尔值，可选）：启用段落模式（默认值：false）

响应格式：

发展

项目结构

关键组件

• YouTubeTranscriptFetcher ：核心成绩单获取功能

• YouTubeUtils ：文本处理和实用程序

特性和功能

• 错误处理：

  • 无效的 URL/ID

  • 无法获取成绩单

  • 语言可用性

  • 网络错误

  • 速率限制

• 文本处理：

  • HTML实体解码

  • 标点规范化

  • 空间规范化

  • 智能段落检测

贡献

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

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

相关项目

• mcp 服务器

• MCP 检查器