YouTube MCP Server Enhanced

MCP音视频

提供方 aranej

音视频 未标注 无需鉴权 社区 / 第三方 Claude

一个为YouTube内容提供标准化接口的MCP服务器实现,支持视频信息获取、字幕管理、频道管理等功能。

一句话选型结论

按资料字段整理

YouTube MCP Server Enhanced 属于音视频类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类音视频 传输方式未标注 鉴权无需鉴权 部署方式支持远程部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

音视频
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

视频信息检索JavaScript本地部署字幕管理频道分析播放列表管理AI集成

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
转写与字幕

把音视频转成文字和字幕。

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在音视频场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
YouTube MCP Server Enhanced当前 未标注 未标注 支持远程部署 无 2026-05-17
Ableton MCP B7b69a6a 16 stdio · 本地进程 本地部署 有 2026-05-17
Mini Max MCP 8 SSE · 服务端推送 远程部署 有 2026-05-18
LocalAI 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Youtube E0eb3510 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Voicemode MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

音视频
字段来自项目仓库与公开索引,中文说明由本站标注
提供方aranej上游标注的维护方 aranej
分类音视频本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.5 KB
来自项目仓库与上游目录的原文,未做删改

YouTube MCP服务器增强

> 增强型分叉 图片/youtube-mcp 修复和改进。

YouTube的模型上下文协议(MCP)服务器实现,使AI语言模型能够通过标准化的界面与YouTube内容进行交互。

什么是增强

  • 所有视频回复都包含直接的YouTube网址(url 和 videoId 字段)
  • 共享实用程序架构(单一事实来源)
  • 延迟初始化以获得更好的性能
  • 90%的代码重复数据消除
  • 更好的错误处理
  • 在Windows上与Claude Code CLI可靠配合使用

特性

视频信息

  • 获取视频详细信息(标题、描述、持续时间等) 使用直接URL
  • 列出频道视频 使用直接URL
  • 获取视频统计数据(浏览量、点赞、评论)
  • 在YouTube上搜索视频 使用直接URL
  • 新:增强的视频响应包括 url 和 videoId 易于集成的字段

成绩单管理

  • 检索视频记录
  • 支持多种语言
  • 获取带有时间戳的字幕
  • 在成绩单中搜索

直接资源和提示

  • 资源:
  • youtube://transcript/{videoId}:直接通过资源URI访问成绩单
  • youtube://info:服务器信息和使用文档(Smithery可发现)
  • 提示:
  • summarize-video:获取和总结视频内容的自动化工作流程
  • analyze-channel:渠道内容策略的综合分析
  • 注释:所有工具都包含功能提示(只读、幂等),以获得更好的LLM性能

渠道管理

  • 获取频道详细信息
  • 列出频道播放列表
  • 获取频道统计信息
  • 在频道内容内搜索

播放列表管理

  • 列出播放列表项目
  • 获取播放列表详细信息
  • 在播放列表中搜索
  • 获取播放列表视频转录

安装

本地安装(推荐)

  1. 克隆此存储库:```bash
    git clone https://github.com/aranej/youtube-mcp-enhanced.git
    cd youtube-mcp-enhanced
    npm install
    npm run build

2. 添加到您的Claude桌面或Claude代码配置:

**克劳德桌面版** (`%APPDATA%\Claude\claude_desktop_config.json` 在Windows上):```json
{
"mcpServers": {
"youtube": {
"command": "node",
"args": ["/path/to/youtube-mcp-enhanced/dist/cli.js"],
"env": {
"YOUTUBE_API_KEY": "your_youtube_api_key_here"
}
}
}
}

克劳德代码CLI (~/.claude.json):```json
{
"mcpServers": {
"youtube": {
"command": "node",
"args": ["/path/to/youtube-mcp-enhanced/dist/cli.js"],
"env": {
"YOUTUBE_API_KEY": "your_youtube_api_key_here"
}
}
}
}


## 配置

设置以下环境变量:

- `YOUTUBE_API_KEY`:您的YouTube数据API密钥(必需)
- `YOUTUBE_TRANSCRIPT_LANG`:成绩单的默认语言(可选,默认为“en”)

## YouTube API设置

1. 转到谷歌云控制台
1. 创建新项目或选择现有项目
1. 启用YouTube数据API v3
1. 创建API凭据(API密钥)
1. 复制API密钥进行配置

## 例子

### 管理视频```javascript
// Get video details (now includes URL)
const video = await youtube.videos.getVideo({
videoId: "dQw4w9WgXcQ"
});

// Enhanced response now includes:
// - video.url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
// - video.videoId: "dQw4w9WgXcQ"
// - All original YouTube API data

// Get video transcript
const transcript = await youtube.transcripts.getTranscript({
videoId: "video-id",
language: "en"
});

// Search videos (results now include URLs)
const searchResults = await youtube.videos.searchVideos({
query: "search term",
maxResults: 10
});

// Each search result includes:
// - result.url: "https://www.youtube.com/watch?v={videoId}"
// - result.videoId: "{videoId}"
// - All original YouTube search data

管理渠道```javascript

// Get channel details
const channel = await youtube.channels.getChannel({
channelId: "channel-id"
});

// List channel videos
const videos = await youtube.channels.listVideos({
channelId: "channel-id",
maxResults: 50
});


### 管理播放列表```javascript
// Get playlist items
const playlistItems = await youtube.playlists.getPlaylistItems({
playlistId: "playlist-id",
maxResults: 50
});

// Get playlist details
const playlist = await youtube.playlists.getPlaylist({
playlistId: "playlist-id"
});

增强的响应结构

带有URL的视频对象

所有与视频相关的响应现在都包含增强的字段,以便于集成:```typescript
interface EnhancedVideoResponse {
// Original YouTube API fields
kind?: string;
etag?: string;
id?: string | YouTubeSearchResultId;
snippet?: YouTubeSnippet;
contentDetails?: any;
statistics?: any;

// NEW: Enhanced fields
url: string; // Direct YouTube video URL
videoId: string; // Extracted video ID
}


### 增强响应示例```json
{
"kind": "youtube#video",
"id": "dQw4w9WgXcQ",
"snippet": {
"title": "Never Gonna Give You Up",
"channelTitle": "Rick Astley",
"description": "Official video for \"Never Gonna Give You Up\""
},
"statistics": {
"viewCount": "1.5B",
"likeCount": "15M"
},
// Enhanced fields:
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"videoId": "dQw4w9WgXcQ"
}

益处

  • 轻松访问URL:无需手动构造URL
  • 一致的结构:搜索和单个视频响应都包含URL
  • 向后兼容:保留所有现有的YouTube API数据
  • 类型安全:完全支持TypeScript

发展```bash

Install dependencies

npm install

Build TypeScript to JavaScript

npm run build

Development mode with auto-rebuild and hot reload

npm run dev

Start the server (requires YOUTUBE_API_KEY)

npm start

Publish to npm (runs build first)

npm run prepublishOnly


### 建筑

此项目使用 **基于服务的双体系结构设计** 具有以下特点:

- **共享公用设施**:所有MCP服务器配置的单一真实来源(`src/server-utils.ts`)
- **现代McpServer**:已从弃用更新 `Server` 类到新 `McpServer`
- **动态版本管理**:版本自动读取自 `package.json`
- **类型安全工具注册**:用途 `zod` 输入验证模式
- **ES模块**:完整的ES模块支持和适当的 `.js` 扩展
- **增强的视频响应**:所有视频操作包括 `url` 和 `videoId` 字段
- **延迟初始化**:仅在需要时初始化YouTube API客户端
- **重复代码删除**:通过共享实用程序消除了90%的代码重复(407→285行)

### 项目结构```diagram
src/
├── server-utils.ts        # 🆕 Shared MCP server utilities (single source of truth)
├── index.ts              # Smithery deployment entry point
├── server.ts             # CLI deployment entry point
├── services/             # Core business logic
│   ├── video.ts         # Video operations (search, getVideo)
│   ├── transcript.ts    # Transcript retrieval
│   ├── playlist.ts      # Playlist operations
│   └── channel.ts       # Channel operations
├── types.ts             # TypeScript interfaces
└── cli.ts               # CLI wrapper for standalone execution

主要特点

  • Smithery优化:通过综合资源、提示和配置,获得了90%以上的Smithery质量分数
  • 共享公用设施架构:通过单一信息源消除了90%的代码重复
  • 增强的视频响应:所有视频对象都包含直接的YouTube URL
  • 灵活的配置:通过Smithery UI或环境变量进行可选配置
  • 类型安全开发:完全支持TypeScript zod 验证
  • 现代MCP工具:用途 registerTool 而不是手动请求处理程序
  • 综合资源:可发现的资源和提示,以更好地整合LLM
  • 错误处理:使用描述性消息进行全面的错误处理

贡献

有关对此存储库的贡献的信息,请参阅CONTRIBUTING.md。

许可证

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

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
YouTube MCP Server Enhanced 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

YouTube MCP Server Enhanced 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

YouTube MCP Server Enhanced 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

YouTube MCP Server Enhanced 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

YouTube MCP Server Enhanced 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

YouTube MCP Server Enhanced 能提供哪些能力?

资料显示能力标签包括 JavaScript、Claude、语音音频。具体工具清单以官方文档为准。

YouTube MCP Server Enhanced 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

YouTube MCP Server Enhanced 是本地还是远程?

它是远程端点,连服务地址即可。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。