Yt Ninja MCP

MCP音视频

提供方 satyamkumar420

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

YT-NINJA是一款AI驱动的YouTube视频分析工具,提供视频播放控制、数据检索、转录管理和高级内容分析功能,适用于内容创作者和数据分析师。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

视频分析TypeScript本地部署AI处理数据检索转录管理YouTube工具

安装与配置

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

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 13 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

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

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

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

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

值得选的地方

  • 资料标注 13 个工具,覆盖面较广,能满足多种调用。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Yt Ninja MCP当前 13 未标注 未标注 无 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

服务器档案

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

详细介绍

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

YT-nija🥷

一个全面的YouTube MCP(模型上下文协议)服务器,提供人工智能驱动的视频分析、播放控制、转录管理和高级内容处理功能。

特性

🎬 视频回放

  • 在浏览器或VLC播放器中播放视频
  • 使用ffplay进行纯音频播放
  • 带时间戳控制的视频片段播放
  • 主动播放会话管理

📊 数据检索

  • 获取详细的视频信息(标题、观看次数、点赞、持续时间等)
  • 获取所有视频的播放列表详细信息
  • 检索频道信息和统计数据
  • 搜索YouTube视频和音乐
  • 下载多种质量的视频缩略图

📝 成绩单管理

  • 获取官方视频记录
  • 人工智能驱动的成绩单生成(官方不可用时)
  • 设置带或不带时间戳的成绩单格式

🤖 AI驱动的分析

  • 生成包含关键点的视频摘要
  • 自动生成章节标记
  • 提取具有相关性得分的相关关键字
  • 检测主题和类别
  • 创建AI驱动的视频亮点

安装

先决条件

  • Node.js>=18.0.0
  • npm>=9.0.0
  • Google Gemini API密钥(人工智能功能所需)
  • 可选:VLC媒体播放器(用于VLC播放)
  • 可选:FFmpeg(用于音频播放和处理)

设置

  1. 克隆存储库:```bash
    git clone
    cd yt-ninja

2. 安装依赖项:```bash
npm install
  1. 配置环境变量:```bash
    cp .env.example .env

编辑 `.env` 并添加您的配置:```env
# Required
GEMINI_API_KEY=your-google-gemini-api-key

# Optional
DOWNLOAD_DIR=./downloads
TEMP_DIR=./temp
MAX_CONCURRENT_DOWNLOADS=3
LOG_LEVEL=info
  1. 构建项目:```bash
    npm run build

## 配置

### 环境变量

|变量|必填|默认|描述|
|----------|----------|---------|-------------|
| `GEMINI_API_KEY` |是|-|Google Generative AI API AI功能密钥|
| `DOWNLOAD_DIR` |没有| `./downloads` |下载文件目录|
| `TEMP_DIR` |没有| `./temp` |临时文件目录|
| `MAX_CONCURRENT_DOWNLOADS` |没有| `3` |最大并发下载量|
| `LOG_LEVEL` |没有| `info` |日志记录级别(错误、警告、信息、调试)|

### 获取Gemini API密钥

1. 访问 谷歌人工智能工作室
1. 使用您的Google帐户登录
1. 单击“创建API密钥”
1. 复制密钥并将其添加到您的 `.env` 文件

### MCP配置

添加到MCP设置文件(`mcp.json`):```json
{
"mcpServers": {
"yt-ninja": {
"command": "node",
"args": ["/path/to/yt-ninja/dist/index.js"],
"env": {
"GEMINI_API_KEY": "your-api-key-here"
},
"disabled": false
}
}
}

可用工具

播放工具

play_youtube_video

在浏览器或VLC播放器中播放YouTube视频。

参数:

  • url (字符串,必填):YouTube视频URL
  • player (字符串,可选):玩家类型- browser 或 vlc (默认值: browser)

例子:```json
{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"player": "browser"
}


### 数据检索工具

#### `get_video_info`

获取有关YouTube视频的全面信息。

**参数:**

- `url` (字符串,必填):YouTube视频URL

**退货:** 视频标题、描述、频道、视图、点赞、持续时间、标签、缩略图等。

#### `get_playlist_info`

获取有关YouTube播放列表的信息。

**参数:**

- `url` (字符串,必填):YouTube播放列表URL

**退货:** 播放列表标题、描述、视频计数、总持续时间、视频列表

#### `get_channel_info`

获取有关YouTube频道的信息。

**参数:**

- `channelId` (字符串,必填):频道ID或URL

**退货:** 频道名称、描述、订阅者数量、总观看次数、视频数量

#### `search_youtube`

在YouTube上搜索视频。

**参数:**

- `query` (字符串,必填):搜索查询
- `maxResults` (数字,可选):最大结果(1-50,默认值:10)

**退货:** 包含视频详细信息的搜索结果数组

#### `search_music`

在YouTube上专门搜索音乐。

**参数:**

- `query` (字符串,必填):音乐搜索查询
- `maxResults` (数字,可选):最大结果(1-50,默认值:10)

**退货:** 音乐搜索结果数组

#### `download_thumbnail`

下载视频缩略图。

**参数:**

- `url` (字符串,必填):YouTube视频URL
- `outputPath` (字符串,可选):输出文件路径
- `quality` (字符串,可选):质量- `maxres`, `high`, `medium`, `default` (默认值: `maxres`)

### 成绩单工具

#### `get_transcript`

获取视频的文字记录/字幕。

**参数:**

- `url` (字符串,必填):YouTube视频URL
- `language` (字符串,可选):语言代码(例如,'en'、'es'、'fr')

**退货:** 转录文本、语言、时间戳、源类型

#### `translate_transcript`

**参数:**

- `url` (字符串,必填):YouTube视频URL
- `targetLanguage` (字符串,必填):目标语言代码

### AI分析工具

#### `summarize_video`

生成基于AI的视频摘要。

**参数:**

- `url` (字符串,必填):YouTube视频URL
- `maxWords` (数字,可选):摘要中的最大字数(默认值:200)

**退货:** 摘要文本、要点、字数

#### `generate_chapters`

自动为视频生成章节标记。

**参数:**

- `url` (字符串,必填):YouTube视频URL

**退货:** 带有时间戳、标题和描述的章节数组

#### `get_keywords`

从视频中提取相关关键字。

**参数:**

- `url` (字符串,必填):YouTube视频URL
- `count` (数字,可选):关键字数量(默认值:15)

**退货:** 具有相关性得分和频率的关键字数组

#### `detect_topics`

检测视频中的主题和类别。

**参数:**

- `url` (字符串,必填):YouTube视频URL

**退货:** 一系列具有置信度得分和类别的主题

#### `generate_video_highlights`

生成AI驱动的视频亮点。

**参数:**

- `url` (字符串,必填):YouTube视频URL
- `count` (数字,可选):突出显示的数量(5-10,默认值:7)

**退货:** 带有时间戳、描述、原因和分数的精彩时刻数组

## 使用示例

### 与一起使用\\

人工智能

配置为MCP服务器后,您可以通过自然语言使用YT-NINJA:```
"Get information about this video: https://www.youtube.com/watch?v=dQw4w9WgXcQ"

"Summarize this YouTube video in 150 words"

"Generate chapters for this tutorial video"

"Extract the top 20 keywords from this video"

"Get the transcript and translate it to Spanish"

程序化使用```typescript

import { dataManager, aiAnalyzer, transcriptManager } from 'yt-ninja';

// Get video info
const videoInfo = await dataManager.getVideoInfo('https://youtube.com/watch?v=...');

// Generate summary
const summary = await aiAnalyzer.summarizeVideo('https://youtube.com/watch?v=...', 200);

// Get transcript
const transcript = await transcriptManager.getTranscript('https://youtube.com/watch?v=...');


## 发展

### 脚本

- `npm run dev` -以热重载的开发模式运行
- `npm run build` -为生产而建
- `npm start` -启动生产服务器
- `npm run lint` -Lint代码
- `npm run format` -使用Prettier格式化代码
- `npm run type-check` -检查TypeScript类型

### 项目结构```
yt-ninja/
├── src/
│   ├── index.ts              # Entry point
│   ├── server.ts             # MCP server setup
│   ├── integrations/         # External service integrations
│   │   ├── youtube.ts        # YouTube API client
│   │   ├── genai.ts          # Google GenAI client
│   │   ├── ffmpeg.ts         # FFmpeg integration
│   │   └── process.ts        # Process management
│   ├── managers/             # Feature managers
│   │   ├── DataManager.ts    # Data retrieval
│   │   ├── PlaybackManager.ts # Playback control
│   │   ├── TranscriptManager.ts # Transcript operations
│   │   ├── AIAnalyzer.ts     # AI analysis
│   │   ├── MediaProcessor.ts # Media processing
│   │   └── AdvancedFeaturesManager.ts # Advanced features
│   ├── types/                # TypeScript type definitions
│   └── utils/                # Utility functions
├── dist/                     # Compiled output
├── downloads/                # Downloaded files
├── .env                      # Environment configuration
└── package.json

错误处理

YT-NINJA提供详细的错误消息和建议:json { "success": false, "error": { "code": "INVALID_URL", "message": "Invalid YouTube video URL", "details": { "url": "..." }, "suggestions": [ "Provide a valid YouTube video URL", "Example: https://www.youtube.com/watch?v=VIDEO_ID" ] } }

常见问题

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

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

Yt Ninja MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Yt Ninja MCP 收费吗?

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

Yt Ninja MCP 需要 API Key 吗?

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

Yt Ninja MCP 能提供哪些能力?

资料显示约 13 个工具;能力标签包括 视频分析、数据检索、TypeScript。具体工具清单以官方文档为准。

热门专题

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

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