Video Transcriber MCP Server

MCP音视频

提供方 nhatvu148

音视频 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude
查看接入方式

一个基于OpenAI Whisper模型的多平台视频转录服务,支持从1000多个视频平台下载音频并转录为多种格式的文本。

一句话选型结论

按资料字段整理

Video Transcriber MCP Server 属于音视频类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

视频转录TypeScript本地部署多平台支持本地处理Whisper模型自动化工具

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install yt-dlp openai-whisper

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

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

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Video Transcriber MCP Server当前 4 stdio · 本地进程 本地部署 有 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

服务器档案

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

详细介绍

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

视频转录器MCP服务器

一种模型上下文协议(MCP)服务器,用于转录来自 1000+平台 使用OpenAI的Whisper模型。使用TypeScript构建以确保类型安全,并可通过npx轻松安装。

> 🚀 寻找更好的性能? 看看 Rust版本 它使用whisper.cpp以更低的内存使用率实现更快的转录。可用 克拉特斯.io 随着 cargo install video-transcriber-mcp.

✨ 最新动态

  • 🌍 多平台支持:现在通过yt-dlp支持1000多个视频平台(YouTube、Vimeo、TikTok、Twitter/X、Facebook、Instagram、Twitch、教育网站等)
  • 💻 交叉平台的:适用于macOS、Linux和Windows
  • 🎛️ 可配置的Whisper型号:从小型、基础型、小型、中型或大型型号中选择
  • 🌐 语言支持:以90多种语言转录或使用自动检测
  • 🔄 自动检索:网络故障通过指数回退自动处理
  • 🎯 平台检测:自动检测视频平台
  • 📋 列出支持的网站:查看所有1000多个支持平台的新工具
  • ⚡ 改进了错误处理:更具体和有用的错误消息
  • 🔒 更好的文件名处理:改进了净化,保留了更多字符

⚠️ 法律声明

此工具仅用于教育、可访问性和研究目的。

在使用此工具之前,请理解:

  • 大多数平台的服务条款通常禁止下载内容
  • 你有责任 确保您的使用符合适用法律
  • 此工具主要用于:
  • ✅ 您自己的内容
  • ✅ 创建无障碍功能(聋人/听力障碍者字幕)
  • ✅ 教育和研究目的(如允许)
  • ✅ 您有明确权限下载的内容

请阅读 法律.md 在使用此工具之前,请参阅详细的法律信息。

我们不鼓励或支持违反任何平台的服务条款或侵犯版权。负责任和合乎道德地使用。

特性

  • 🎥 从1000多个视频平台下载音频(由yt-dlp提供支持)
  • 📂 转录本地视频文件**(mp4、avi、mov、mkv等)
  • 🎤 使用OpenAI Whisper进行转录(本地,不需要API密钥)
  • 🎛️ 可配置的Whisper型号(微型、基础型、小型、中型、大型)
  • 🌐 支持90多种语言,具有自动检测功能
  • 📝 生成多种格式的成绩单(TXT、JSON、Markdown)
  • 📚 列出并阅读以前的成绩单作为MCP资源
  • 🔌 与Claude Code或任何MCP客户端无缝集成
  • ⚡ TypeScript+npx易于安装
  • 🔒 TypeScript的完全类型安全
  • 🔍 自动依赖性检查
  • 🔄 网络故障的自动重试逻辑
  • 🎯 平台检测(显示您正在从哪个平台转录)

支持的平台

多亏了yt-dlp,这个工具支持 1000+视频平台 包括:

  • 社交媒体:YouTube、TikTok、推特/X、脸书、Instagram、Reddit、领英
  • 视频托管:Vimeo、Dailymotion、Twitch
  • 教育的:Coursera、Udemy、可汗学院、领英学习、edX
  • 新闻:英国广播公司、美国有线电视新闻网、美国全国广播公司、英国公共广播公司
  • 会议/技术:YouTube(技术讲座)、Vimeo(会议)
  • 还有很多,更多!

跑 list_supported_sites 工具查看1000+支持平台的完整列表。

先决条件

macOS```bash

brew install yt-dlp # Video downloader (supports 1000+ sites)
brew install openai-whisper # Whisper transcription
brew install ffmpeg # Audio processing


### Linux```bash
# Ubuntu/Debian
sudo apt update
sudo apt install ffmpeg
pip install yt-dlp openai-whisper

# Fedora/RHEL
sudo dnf install ffmpeg
pip install yt-dlp openai-whisper

# Arch Linux
sudo pacman -S ffmpeg
pip install yt-dlp openai-whisper

视窗

选项1:使用pip(推荐)```powershell

Install Python from python.org first

pip install yt-dlp openai-whisper

Install ffmpeg using Chocolatey

choco install ffmpeg

Or download ffmpeg from: https://ffmpeg.org/download.html


**选项2:使用翼子板**```powershell
winget install yt-dlp.yt-dlp
winget install Gyan.FFmpeg
pip install openai-whisper

验证安装(所有平台)```bash

yt-dlp --version
whisper --version
ffmpeg -version


## 快速开始

### 面向最终用户(使用npx)

添加到您的Claude代码配置中(`~/.claude/settings.json`):```json
{
"mcpServers": {
"video-transcriber": {
"command": "npx",
"args": ["-y", "video-transcriber-mcp"]
}
}
}

或者直接从GitHub使用:```json
{
"mcpServers": {
"video-transcriber": {
"command": "npx",
"args": [
"-y",
"github:nhatvu148/video-transcriber-mcp"
]
}
}
}


就是这样!无需安装。npx将自动下载并运行该包。

### 促进地方发展```bash
# Clone the repository
git clone https://github.com/nhatvu148/video-transcriber-mcp.git
cd video-transcriber-mcp

# Install dependencies
npm install
# or
bun install

# Build the project
npm run build

# Use in Claude Code with local path
{
"mcpServers": {
"video-transcriber": {
"command": "npx",
"args": ["-y", "/path/to/video-transcriber-mcp"]
}
}
}

用法

来自克劳德代码

配置后,您可以在Claude Code中使用这些工具:

从任何平台转录视频```

Please transcribe this YouTube video: https://www.youtube.com/watch?v=VIDEO_ID

Transcribe this TikTok video: https://www.tiktok.com/@user/video/123456789

Get the transcript from this Vimeo video with high accuracy: https://vimeo.com/123456789
(use model: large)

Transcribe this Spanish tutorial video: https://youtube.com/watch?v=VIDEO_ID
(language: es)
```

#### 转录本地视频文件```
Transcribe this local video file: /Users/myname/Videos/meeting.mp4

Transcribe ~/Downloads/lecture.mov with high accuracy
(use model: medium)


克劳德将使用 `transcribe_video` 该工具自动提供模型和语言的可选参数。

#### 列出所有支持的平台```
What platforms can you transcribe videos from?

列出可用成绩单```

List all my video transcripts


#### 检查相关性```
Check if my video transcriber dependencies are installed

阅读成绩单```

Show me the transcript for [video name]


### 编程式用法

如果安装该软件包:```bash
npm install video-transcriber-mcp

您可以通过编程方式导入和使用它:```typescript
import { transcribeVideo, checkDependencies, WhisperModel } from 'video-transcriber-mcp';

// Check dependencies
checkDependencies();

// Transcribe a video from URL with custom options
const result = await transcribeVideo({
url: 'https://www.youtube.com/watch?v=VIDEO_ID',
outputDir: '/path/to/output',
model: 'medium', // tiny, base, small, medium, large
language: 'en', // or 'auto' for auto-detection
onProgress: (progress) => console.log(progress)
});

// Or transcribe a local video file
const localResult = await transcribeVideo({
url: '/path/to/video.mp4', // Local file path instead of URL
outputDir: '/path/to/output',
model: 'base',
language: 'auto',
onProgress: (progress) => console.log(progress)
});

console.log('Title:', result.metadata.title);
console.log('Platform:', result.metadata.platform);
console.log('Files:', result.files);


## 输出

成绩单保存到 `~/Downloads/video-transcripts/` 默认情况下。

对于每个视频,生成三个文件:

1. **`.txt`** -纯文本转录
1. **`.json`** -带有时间戳和元数据的JSON
1. **`.md`** -带视频元数据和格式化转录的Markdown

### 示例```
~/Downloads/video-transcripts/
├── 7JBuA1GHAjQ-From-AI-skeptic-to-UNFAIR-advantage.txt
├── 7JBuA1GHAjQ-From-AI-skeptic-to-UNFAIR-advantage.json
└── 7JBuA1GHAjQ-From-AI-skeptic-to-UNFAIR-advantage.md

MCP工具

transcribe_video

将来自1000多个平台或本地视频文件的视频转录为文本。

参数:

  • url (必填):来自任何支持平台的视频URL或本地视频文件(mp4、avi、mov、mkv等)的路径
  • output_dir (可选):输出目录路径
  • model (可选):Whisper型号-“微型”、“基础”(默认)、“小型”、“中型”、“大型”
  • language (可选):语言代码(ISO 639-1:“en”、“es”、“fr”等)或“auto”(默认)

型号比较:

型号 速度 精度 用例
微小 ⚡⚡⚡⚡⚡ ⭐⭐ 快速草稿、测试
基础 ⚡⚡⚡⚡ ⭐⭐⭐ 一般用途(默认)
小 ⚡⚡⚡ ⭐⭐⭐⭐ 更准确
中等 ⚡⚡ ⭐⭐⭐⭐⭐ 高精度
大 ⚡ ⭐⭐⭐⭐⭐⭐ 精度最高,速度较慢

list_transcripts

列出所有可用的转录本及其元数据。

参数:

  • output_dir (可选):要列出的目录

check_dependencies

验证是否安装了所有必需的依赖项。

list_supported_sites

列出所有1000+支持的视频平台。

配置示例

克劳德代码(推荐)```json

{
"mcpServers": {
"video-transcriber": {
"command": "npx",
"args": ["-y", "video-transcriber-mcp"]
}
}
}


### 来自GitHub(最新)```json
{
"mcpServers": {
"video-transcriber": {
"command": "npx",
"args": ["-y", "github:nhatvu148/video-transcriber-mcp"]
}
}
}

本地开发```json

{
"mcpServers": {
"video-transcriber": {
"command": "npx",
"args": ["-y", "/absolute/path/to/video-transcriber-mcp"]
}
}
}


## 发展

### 设置```bash
# Install dependencies
npm install

# Build the project
npm run build

# Type check
npm run check

# Development mode (requires Bun)
bun run dev

# Clean build artifacts
npm run clean

项目结构```

video-transcriber-mcp/
├── src/
│ ├── index.ts # MCP server implementation
│ └── transcriber.ts # Core transcription logic
├── dist/ # Built JavaScript (generated)
├── package.json # Package configuration
├── tsconfig.json # TypeScript configuration
├── LICENSE # MIT License
└── README.md # This file


### 脚本

|命令|描述|
|---------|-------------|
| `npm run build` |将TypeScript编译为JavaScript|
| `npm run dev` |热重载开发模式(Bun)|
| `npm run check` |TypeScript类型检查|
| `npm run clean` |删除dist/目录|
| `npm run prepublishOnly` |预发布构建(自动)|

### 出版```bash
# Build the project
npm run build

# Test locally first
npx . --help

# Publish to npm (bump version first)
npm version patch  # or minor, major
npm publish

# Or publish from GitHub
# Push to GitHub and users can use:
# npx github:username/video-transcriber-mcp

故障排除

未安装依赖项

看 先决条件 以上部分为平台特定的安装说明。

npx找不到包

确保包装是:

  • 发布到npm,OR
  • 在GitHub上提供正确的package.json

TypeScript错误```bash

npm run check


### 权限不足

构建过程会自动生成 `dist/index.js` 可通过 `fix-shebang` 脚本。

### “不支持的URL”错误

yt-dlp可能不支持该平台。跑 `list_supported_sites` 查看所有支持的平台。

## 演出

|视频长度|处理时间(基本型号)|输出大小|
|--------------|------------------------------|-------------|
|5分钟|~1-2分钟|~5-10 KB|
|10分钟|~2-4分钟|~10-20KB|
|30分钟|~5-10分钟|~30-50 KB|
|1小时|~10-20分钟|~60-100KB|

*时间是近似的,取决于CPU速度和型号选择*

## 高级配置

### 定制Whisper型号

在工具调用参数中指定:```json
{
"url": "https://youtube.com/watch?v=...",
"model": "large"
}

自定义语言

指定语言代码:```json
{
"url": "https://youtube.com/watch?v=...",
"language": "es"
}


### 自定义输出目录

在工具调用中指定:```json
{
"url": "https://youtube.com/watch?v=...",
"output_dir": "/custom/path"
}

贡献

欢迎投稿!拜托:

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用,添加测试
  5. 提交拉取请求

许可证

MIT许可证-请参阅 许可证 详细信息文件

TypeScript与Rust版本

这是 TypeScript版本 -非常适合:

  • ✅ 使用npx快速设置(无需安装)
  • ✅ 熟悉Node.js生态系统
  • ✅ 易于修改和扩展
  • ✅ 有利于学习和原型制作

考虑一下 Rust版本 如果你需要:

  • 🚀 更快的转录 (使用耳语.cpp)
  • 💾 降低内存使用率
  • ⚡ 本地性能
  • 📦 独立二进制 (不需要Node.js)

两个版本都支持相同的MCP协议,并且与Claude Code的工作方式相同!

链接

  • GitHub 仓库
  • npm包
  • 🦀 Rust版本 ← 为了获得更好的性能
  • 问题
  • 模型上下文协议

致谢

  • OpenAI Whisper用于转录
  • yt-dlp用于多平台视频下载(1000+站点)
  • 模型上下文协议SDK
  • 克劳德Anthropic

由以下材料制成❤️ 对于MCP社区

常见问题

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

在客户端按下面的安装命令接入:pip install yt-dlp openai-whisper。装完在客户端配置里引用同一个包或端点。

Video Transcriber MCP Server 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Video Transcriber MCP Server 收费吗?

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

Video Transcriber MCP Server 需要 API Key 吗?

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

Video Transcriber MCP Server 支持哪些客户端?

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

Video Transcriber MCP Server 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 本地处理、TypeScript、Claude、多平台支持。具体工具清单以官方文档为准。

Video Transcriber MCP Server 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Video Transcriber MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

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

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