Youtube Caption MCP

MCP搜索检索

提供方 iamyosuke

搜索检索 未标注 API Key 社区 / 第三方 Cursor

An MCP server for cursor to retrieve YouTube video captions without requiring an API key.

一句话选型结论

按资料字段整理

Youtube Caption MCP 属于搜索检索类 MCP 服务器,传输方式未标注,API Key,可直接接入 Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

research-and-datayoutubecaptionsmcpsubtitlesapi

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

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

值得选的地方

  • 已适配 Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Youtube Caption MCP当前 未标注 未标注 未标注 无 2026-05-18
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

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

详细介绍

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

this is vibe coded BE CAREFUL

YouTube Caption MCP Server

Vive
An MCP server for Cursor to retrieve YouTube video captions. Access YouTube video caption information without requiring an API key.

Features

  • No API Key Required: Access YouTube's internal API using the youtube-js library
  • Multilingual Support: Automatic detection and retrieval of available caption languages
  • Format Conversion: Caption output in Raw, SRT, and VTT formats
  • Caching: In-memory caching for improved performance
  • Claude Integration: Seamless integration via MCP protocol

Installation

Install from NPM```bash

npm install -g @iamyosuke/youtube-caption-mcp


### Build from Source```bash
git clone https://github.com/iamyosuke/youtube-caption-mcp.git
cd youtube-caption-mcp
npm install
npm run build

Cursor Configuration

Add the following to your Cursor configuration file (.cursor/mcp.json):```json
{
"mcpServers": {
"youtube-caption-mcp": {
"command": "npx",
"args": ["-y", "youtube-caption-mcp", "--stdio"],
"env": {
"CACHE_ENABLED": "true",
"LOG_LEVEL": "debug"
}
}
}
}


## Available Tools

### 1. get_video_info

Retrieves basic information about a YouTube video.

**Parameters:**
- `video_id` (required): YouTube video ID or URL

**Example:**```json
{
  "video_id": "dQw4w9WgXcQ"
}

2. get_captions_list

Retrieves a list of available captions for a video.

Parameters:
- video_id (required): YouTube video ID or URL

Example:```json
{
"video_id": "dQw4w9WgXcQ"
}


### 3. download_captions

Downloads captions for a specified video.

**Parameters:**
- `video_id` (required): YouTube video ID or URL
- `lang` (optional): Caption language code (default: "ja")
- `format` (optional): Output format - "raw", "srt", "vtt" (default: "raw")

**Example:**```json
{
  "video_id": "dQw4w9WgXcQ",
  "lang": "ja",
  "format": "srt"
}

4. search_videos_with_captions

Searches for videos with captions.

Parameters:
- query (required): Search query
- lang (optional): Caption language filter
- limit (optional): Maximum number of search results (1-50, default: 10)

Example:```json
{
"query": "programming tutorial",
"lang": "en",
"limit": 5
}


## Supported URL Formats

The following YouTube URL formats are supported:

- `https://www.youtube.com/watch?v=VIDEO_ID`
- `https://youtu.be/VIDEO_ID`
- `https://www.youtube.com/embed/VIDEO_ID`
- `VIDEO_ID` (11-character video ID)

## Environment Variables

| Variable Name | Default Value | Description |
|---------------|---------------|-------------|
| `CACHE_ENABLED` | `true` | Enable/disable caching |
| `CACHE_DEFAULT_TTL` | `3600` | Default cache retention time (seconds) |
| `CACHE_MAX_KEYS` | `1000` | Maximum number of cache keys |
| `LOG_LEVEL` | `info` | Log level (debug, info, warn, error) |

## Development

### Setup Development Environment```bash
npm install

Start Development Server```bash

npm run dev


### Run Tests```bash
npm test

Build```bash

npm run build


### Lint & Format```bash
npm run lint
npm run format

License

MIT License

Contributions

Pull requests and issue reports are welcome.

Disclaimer

Note: This project was vibe coded for three hours on a weekend and hasn't been thoroughly tested. Use in production environments at your own risk.

Caution

  • Please use this tool in accordance with YouTube's Terms of Service
  • Handle copyrighted content appropriately
  • Be mindful of rate limits when sending many requests

Troubleshooting

Common Issues

  1. Video Not Found
    - Check if the video ID or URL is correct
    - Check if the video is publicly available

  2. Cannot Get Captions
    - Check if the video has captions
    - Check if the specified language captions are available

  3. Slow Performance
    - Check if caching is enabled
    - Check your network connection

Checking Logs

To view detailed logs, set the environment variable LOG_LEVEL=debug:```bash
LOG_LEVEL=debug npx @iamyosuke/youtube-caption-mcp


---

# YouTube字幕MCPサーバー

Cusor 向けのYouTube動画字幕取得MCPサーバーです。APIキー不要でYouTube動画の字幕情報を取得できます。

## 特徴

- **APIキー不要**: youtube-jsライブラリを使用してYouTubeの内部APIにアクセス
- **多言語対応**: 利用可能な字幕言語の自動検出と取得
- **フォーマット変換**: Raw、SRT、VTT形式での字幕出力
- **キャッシュ機能**: パフォーマンス向上のためのインメモリキャッシュ
- **Claude統合**: MCPプロトコルによるシームレスな連携

## インストール

### NPMからインストール```bash
npm install -g @iamyosuke/youtube-caption-mcp

ソースからビルド```bash

git clone https://github.com/iamyosuke/youtube-caption-mcp.git
cd youtube-caption-mcp
npm install
npm run build


### Cursor設定

Cursorの設定ファイル(`.cursor/mcp.json`)に以下を追加してください:```json
{
  "mcpServers": {
    "youtube-caption-mcp": {
      "command": "npx",
      "args": ["-y", "youtube-caption-mcp", "--stdio"],
      "env": {
        "CACHE_ENABLED": "true",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

利用可能なツール

1. get_video_info

YouTube動画の基本情報を取得します。

パラメータ:
- video_id (必須): YouTube動画IDまたはURL

例:```json
{
"video_id": "dQw4w9WgXcQ"
}


### 2. get_captions_list

動画で利用可能な字幕一覧を取得します。

**パラメータ:**
- `video_id` (必須): YouTube動画IDまたはURL

**例:**```json
{
  "video_id": "dQw4w9WgXcQ"
}

3. download_captions

指定された動画の字幕をダウンロードします。

パラメータ:
- video_id (必須): YouTube動画IDまたはURL
- lang (オプション): 字幕の言語コード(デフォルト: "ja")
- format (オプション): 出力形式 - "raw", "srt", "vtt"(デフォルト: "raw")

例:```json
{
"video_id": "dQw4w9WgXcQ",
"lang": "ja",
"format": "srt"
}


### 4. search_videos_with_captions

字幕付きの動画を検索します。

**パラメータ:**
- `query` (必須): 検索クエリ
- `lang` (オプション): 字幕の言語フィルタ
- `limit` (オプション): 検索結果の最大数(1-50、デフォルト: 10)

**例:**```json
{
  "query": "プログラミング チュートリアル",
  "lang": "ja",
  "limit": 5
}

対応URL形式

以下のYouTube URL形式に対応しています:

  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
  • https://www.youtube.com/embed/VIDEO_ID
  • VIDEO_ID (11文字の動画ID)

環境変数

変数名 デフォルト値 説明
CACHE_ENABLED true キャッシュ機能の有効/無効
CACHE_DEFAULT_TTL 3600 デフォルトキャッシュ保持時間(秒)
CACHE_MAX_KEYS 1000 最大キャッシュキー数
LOG_LEVEL info ログレベル(debug, info, warn, error)

開発

開発環境のセットアップ```bash

npm install


### 開発サーバーの起動```bash
npm run dev

テストの実行```bash

npm test


### ビルド```bash
npm run build

リント・フォーマット```bash

npm run lint
npm run format


## ライセンス

MIT License

## 貢献

プルリクエストやイシューの報告を歓迎します。

## 免責事項

**注意**: このプロジェクトは週末の3時間で作成されたものであり、十分なテストが行われていません。本番環境での使用は自己責任でお願いします。

## 注意事項

- このツールはYouTubeの利用規約に従って使用してください
- 著作権保護されたコンテンツの適切な取り扱いにご注意ください
- 大量のリクエストを送信する際は、レート制限にご注意ください

## トラブルシューティング

### よくある問題

1. **動画が見つからない**
   - 動画IDまたはURLが正しいか確認してください
   - 動画が公開されているか確認してください

2. **字幕が取得できない**
   - 動画に字幕が存在するか確認してください
   - 指定した言語の字幕が利用可能か確認してください

3. **パフォーマンスが遅い**
   - キャッシュが有効になっているか確認してください
   - ネットワーク接続を確認してください

### ログの確認

詳細なログを確認するには、環境変数 `LOG_LEVEL=debug` を設定してください。

```bash
LOG_LEVEL=debug npx @iamyosuke/youtube-caption-mcp

常见问题

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

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

Youtube Caption MCP 怎么在 Cursor 里配置?

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

Youtube Caption MCP 收费吗?

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

Youtube Caption MCP 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Youtube Caption MCP 支持哪些客户端?

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

Youtube Caption MCP 能提供哪些能力?

资料显示能力标签包括 API集成、Cursor、搜索。具体工具清单以官方文档为准。

热门专题

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

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