YouTube MCP 集成

本项目提供了一个用于 YouTube 的 模型上下文协议 (MCP) 集成，允许 LLM 通过标准化工具搜索 YouTube、获取视频信息和检索字幕。

功能

• YouTube 搜索工具: 在 YouTube 上搜索视频，可配置结果数量限制
• 视频信息工具: 获取 YouTube 视频的详细信息
• 字幕工具: 检索和解析 YouTube 视频的字幕

架构

该实现遵循模型上下文协议 (MCP) 规范，该规范标准化了 LLM 与外部工具和资源交互的方式。该架构包括：

1. MCP 服务器: 通过 HTTP/SSE 传输提供 YouTube 功能作为 MCP 工具
2. YouTube API 集成: 抓取 YouTube 数据以提供搜索、视频信息和字幕功能
3. MCP 客户端: 示例客户端，展示如何使用 MCP YouTube 工具

快速开始

前提条件

• Node.js 18+
• npm

安装

# 克隆仓库
git clone https://github.com/your-username/ephor-youtube-mcp.git
cd ephor-youtube-mcp

# 安装依赖
npm install

# 构建项目
npm run build

运行服务器

启动 MCP 服务器：

npm run start

服务器将在 http://localhost:3000 上启动，并具有以下端点：

• SSE 端点: /sse
• 消息端点: /messages

与 MCP 客户端一起使用

MCP 工具可以与任何兼容 MCP 的客户端一起使用。 以下是如何使用这些工具的示例：

// 初始化客户端
const client = new Client(
  { name: 'youtube-client', version: '1.0.0' },
  { capabilities: { tools: {} } }
);

// 连接到服务器
await client.connect(transport);

// 搜索 YouTube
const searchResults = await client.callTool({
  name: 'youtube_search',
  arguments: {
    query: 'javascript tutorial',
    limit: 3
  }
});

// 获取视频信息
const videoInfo = await client.callTool({
  name: 'youtube_get_video_info',
  arguments: {
    input: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
  }
});

// 获取视频字幕
const transcript = await client.callTool({
  name: 'youtube_get_transcript',
  arguments: {
    input: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
  }
});

可用工具

youtube_search

搜索 YouTube 视频。

参数：

• query (字符串，必需): 搜索查询
• limit (数字，可选): 最大结果数 (1-10, 默认: 5)

响应： 包含视频结果列表，其中包含标题、视频 ID、URL、缩略图、描述、频道信息、观看次数和发布日期等详细信息。

youtube_get_video_info

获取 YouTube 视频的详细信息。

参数：

• input (字符串，必需): YouTube 视频 ID 或 URL

响应： 详细的视频信息，包括标题、描述、观看次数、发布日期、频道详细信息和缩略图 URL。

youtube_get_transcript

获取 YouTube 视频的字幕。

参数：

• input (字符串，必需): YouTube 视频 ID 或 URL

响应： 带有时间戳条目的视频字幕，以及基本的视频信息。

许可证

MIT

鸣谢

• 模型上下文协议