DeepSRT MCP

DeepSRT MCP服务器

模型上下文协议（MCP）服务器，通过与DeepSRT的API集成和直接访问YouTube字幕，提供YouTube视频摘要和转录提取功能。

太长，读不下去了

{
  "mcpServers": {
    "deepsrt": {
      "type": "stdio",
      "command": "bunx",
      "args": [
        "@deepsrt/deepsrt-mcp@latest",
        "--server"
      ]
    }
  }
}

建筑

graph TB
    subgraph "MCP Client"
        Client[Claude Desktop / Cline]
    end
    
    subgraph "DeepSRT MCP Server"
        Server[MCP Server]
        SummaryTool[get_summary]
        TranscriptTool[get_transcript]
        
        Server --> SummaryTool
        Server --> TranscriptTool
    end
    
    subgraph "External APIs"
        YouTube[YouTube InnerTube API]
        DeepSRT[DeepSRT Worker API]
        Captions[YouTube Caption API]
    end
    
    Client --> Server
    SummaryTool --> YouTube
    SummaryTool --> DeepSRT
    TranscriptTool --> YouTube
    TranscriptTool --> Captions

顺序流

sequenceDiagram
    participant User
    participant MCP as MCP Client
    participant Server as DeepSRT MCP Server
    participant YouTube as YouTube InnerTube API
    participant DeepSRT as DeepSRT Worker API
    participant Captions as YouTube Caption API

    Note over User,Captions: Summary Generation Flow
    User->>MCP: Request video summary
    MCP->>Server: get_summary(videoId, lang, mode)
    
    Server->>Server: Extract video ID from URL
    Server->>YouTube: POST /youtubei/v1/player
    Note right of YouTube: Get video metadata
and caption tracks
    YouTube-->>Server: Video details + caption tracks
    
    Server->>Server: Select best caption track
(manual > auto-generated)
    Server->>Server: Extract transcript argument
from caption URL
    
    par Summary Request
        Server->>DeepSRT: GET /transcript2?action=summarize
        Note right of DeepSRT: X-Transcript-Arg header
contains caption URL params
        DeepSRT-->>Server: Generated summary
    and Title Translation
        Server->>DeepSRT: GET /transcript2?action=translate
        DeepSRT-->>Server: Translated title
    end
    
    Server->>Server: Format markdown response
with metadata + summary
    Server-->>MCP: Formatted summary response
    MCP-->>User: Display summary

    Note over User,Captions: Transcript Extraction Flow
    User->>MCP: Request video transcript
    MCP->>Server: get_transcript(videoId, lang)
    
    Server->>Server: Extract video ID from URL
    Server->>YouTube: POST /youtubei/v1/player
    YouTube-->>Server: Video details + caption tracks
    
    Server->>Server: Select best caption track
for preferred language
    Server->>Captions: GET caption XML from baseUrl
    Captions-->>Server: Raw XML transcript
    
    Server->>Server: Parse XML transcript
- Extract timestamps
- Decode HTML entities
- Format text
    Server->>Server: Generate markdown response
with timestamps
    Server-->>MCP: Formatted transcript
    MCP-->>User: Display transcript with timestamps

技术架构

核心组件

1. MCP服务器层

• 运行时支持：Node.js和Bun执行
• 协议处理：模型上下文协议（MCP）请求/响应管理
• 工具注册: get_summary 和 get_transcript 工具
• 错误处理：通过用户友好的消息进行全面的错误管理

2. 视频处理流水线

• URL解析器：支持多种YouTube URL格式和直接视频ID
• InnerTube集成：无需API密钥即可直接访问YouTube API
• 标题发现：自动检测可用字幕轨道
• 质量选择：手动字幕优先于自动生成字幕

3. 成绩单处理

• 解析器：处理YouTube的 `` 格式
• 实体解码器：将HTML实体转换为可读文本
• 时间戳格式化程序：将毫秒转换为 [MM:SS] 格式
• 内容过滤：删除乐谱和空段

4. 摘要生成

• 深度SRT集成：将API直接调用到 worker.deepsrt.com
• 多语言支持：支持zh-tw、en、ja和其他语言
• 模式选择：叙述和要点摘要格式
• 标题翻译：自动将标题翻译成目标语言

主要特点

无需预缓存

• 适用于任何带有字幕的YouTube视频
• 实时转录提取和处理
• 不依赖于外部缓存系统

智能字幕选择

• 优先顺序：手动>自动生成>任何可用
• 语言首选项：尊重用户的首选语言
• 回退策略：对可用选项的优雅降级

稳健的错误处理

• 网络超时管理（30秒超时）
• API错误转换为用户友好的消息
• 对无字幕视频的优雅处理
• 输入参数的全面验证

多格式输出

• Markdown格式：带有标题和元数据的富文本
• 结构化数据：视频信息、持续时间、作者详细信息
• 带时间戳的成绩单：精确的计时信息
• 本地化摘要：用户首选语言的内容

性能特征

• 快速启动：\>MCP: Request video summary

MCP->>YouTube: Get video info & captions via InnerTube API YouTube-->>MCP: Return video details & caption tracks MCP->>YouTube: Fetch transcript XML from caption URL YouTube-->>MCP: Return raw transcript content MCP->>DeepSRT: Send transcript + metadata for summarization DeepSRT-->>MCP: Return generated summary MCP-->>User: Return formatted summary

Note over User,DeepSRT: Transcript Extraction Flow (Direct) User->>MCP: Request video transcript MCP->>YouTube: Get video info & captions via InnerTube API YouTube-->>MCP: Return video details & caption tracks MCP->>YouTube: Fetch transcript XML from caption URL YouTube-->>MCP: Return raw transcript content MCP->>MCP: Parse & format transcript with timestamps MCP-->>User: Return formatted transcript with metadata

## CLI使用情况

DeepSRT MCP服务器提供了一个统一的界面，可以处理MCP服务器模式和CLI命令。

### 统一接口

MCP Server Mode (default - for Claude Desktop/Cline)

bunx @deepsrt/deepsrt-mcp # Starts MCP server on stdio bunx @deepsrt/deepsrt-mcp --server # Explicit server mode

CLI Commands (direct usage)

bunx @deepsrt/deepsrt-mcp get-transcript [options] bunx @deepsrt/deepsrt-mcp get-summary [options]

Help

bunx @deepsrt/deepsrt-mcp --help

### 直接CLI命令（无需安装）

Extract transcript with timestamps

bunx @deepsrt/deepsrt-mcp get-transcript https://www.youtube.com/watch?v=dQw4w9WgXcQ bunx @deepsrt/deepsrt-mcp get-transcript dQw4w9WgXcQ --lang=en

Generate video summary

bunx @deepsrt/deepsrt-mcp get-summary dQw4w9WgXcQ --lang=zh-tw --mode=bullet bunx @deepsrt/deepsrt-mcp get-summary https://youtu.be/dQw4w9WgXcQ --lang=ja

### 全球安装

为了便于访问，请全局安装：

Install globally

npm install -g @deepsrt/deepsrt-mcp

MCP Server Mode

deepsrt-mcp # Starts MCP server deepsrt-mcp --server # Explicit server mode

CLI Commands

deepsrt-mcp get-transcript https://youtu.be/dQw4w9WgXcQ --lang=en deepsrt-mcp get-summary dQw4w9WgXcQ --lang=zh-tw --mode=narrative

### CLI选项

#### 获取成绩单

bunx @deepsrt/deepsrt-mcp get-transcript [options]

Options: --lang= Preferred language code for captions (default: en) --lang Alternative format Examples: en, zh-tw, ja, es, fr

Examples: bunx @deepsrt/deepsrt-mcp get-transcript https://www.youtube.com/watch?v=dQw4w9WgXcQ bunx @deepsrt/deepsrt-mcp get-transcript dQw4w9WgXcQ --lang=zh-tw bunx @deepsrt/deepsrt-mcp get-transcript https://youtu.be/dQw4w9WgXcQ --lang ja

#### 获取摘要

bunx @deepsrt/deepsrt-mcp get-summary [options]

Options: --lang= Target language for summary (default: zh-tw) --lang Alternative format Examples: zh-tw, en, ja, es, fr --mode= Summary format (default: narrative) --mode Alternative format Options: narrative, bullet

Examples: bunx @deepsrt/deepsrt-mcp get-summary https://www.youtube.com/watch?v=dQw4w9WgXcQ bunx @deepsrt/deepsrt-mcp get-summary dQw4w9WgXcQ --lang=en --mode=bullet bunx @deepsrt/deepsrt-mcp get-summary https://youtu.be/dQw4w9WgXcQ --lang ja --mode narrative

### 支持的URL格式

CLI接受多种YouTube URL格式：

Full YouTube URLs

https://www.youtube.com/watch?v=dQw4w9WgXcQ https://www.youtube.com/watch?v=dQw4w9WgXcQ&t=30s

Short URLs

https://youtu.be/dQw4w9WgXcQ

Embed URLs

https://www.youtube.com/embed/dQw4w9WgXcQ

Direct video IDs

dQw4w9WgXcQ

### CLI功能

- **直接执行**：无需安装 `bunx`
- **多种URL格式**：完整URL、短URL或直接视频ID
- **灵活的论证格式**：两者都有 `--key=value` 和 `--key value` 支持的格式
- **语言支持**：指定摘要和成绩单首选项的目标语言
- **摘要模式**：在叙述或要点格式之间进行选择
- **产量丰富**：带进度指示器的彩色控制台输出
- **错误处理**：清除带有建议的错误消息

### 输出示例

#### 成绩单输出

Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)

Author: Rick Astley Duration: 3:33 Captions: English (manual)

Transcript

[00:18] ♪ We're no strangers to love ♪ [00:22] ♪ You know the rules and so do I ♪ [00:27] ♪ A full commitment's what I'm thinking of ♪ ...

#### 摘要输出（叙述模式）

瑞克·艾斯利 - 永遠不會放棄你

Author: Rick Astley Duration: 3:33 Language: zh-tw Mode: narrative

Summary

這是一首經典的流行歌曲，表達了對愛情的承諾和忠誠...

#### 摘要输出（项目符号模式）

How Robots Are Helping Amazon Deliver on Prime Day

Author: Bloomberg Television Duration: 5:45 Language: zh-tw Mode: bullet

Summary

本影片主要探討亞馬遜如何運用機器人技術來提升倉儲效率...

機器人技術在亞馬遜倉儲的應用與效益

- 亞馬遜已部署了第一百萬個機器人，並在Prime Day等高峰期用於滿足訂單需求 [00:00:00] - 機器人旨在為員工提供安全且高生產力的工作環境 [00:00:30] - 移動機器人可以搬運超過一千磅的貨物，並移動貨架以減少員工的行走距離 [00:00:54] ...

## 安装

### 选项1：直接与bunx一起使用（推荐-无需安装）

直接使用统一界面，无需任何安装：

MCP Server Mode (for Claude Desktop/Cline)

bunx @deepsrt/deepsrt-mcp # Default: starts MCP server bunx @deepsrt/deepsrt-mcp --server # Explicit server mode

CLI Commands (direct usage)

bunx @deepsrt/deepsrt-mcp get-transcript https://www.youtube.com/watch?v=dQw4w9WgXcQ bunx @deepsrt/deepsrt-mcp get-summary dQw4w9WgXcQ --lang=zh-tw --mode=bullet

Always uses latest version automatically

bunx @deepsrt/deepsrt-mcp@latest get-transcript dQw4w9WgXcQ --lang=en

### 选项2：全局安装（用于频繁使用）

Install globally for easier access

npm install -g @deepsrt/deepsrt-mcp

Then use directly with shorter command

deepsrt-mcp get-transcript https://www.youtube.com/watch?v=dQw4w9WgXcQ deepsrt-mcp get-summary dQw4w9WgXcQ --lang zh-tw --mode bullet

### 选项3：为Claude Desktop安装（推荐）

将此配置添加到您的Claude Desktop配置文件中：

- 在macOS上： `~/Library/Application Support/Claude/claude_desktop_config.json`
- 在Windows上： `%APPDATA%/Claude/claude_desktop_config.json`

{ "mcpServers": { "deepsrt": { "type": "stdio", "command": "bunx", "args": [ "@deepsrt/deepsrt-mcp@latest", "--server" ] } } }

这种方法：

- ✅ **无需本地安装**
- ✅ **始终使用最新版本**
- ✅ **自动更新** 当你重启克劳德时
- ✅ **跨平台兼容性**
- ✅ **简单干净的配置**

### 选项4：安装Cline

将此配置添加到您的 `cline_mcp_settings.json`:

{ "mcpServers": { "deepsrt": { "type": "stdio", "command": "bunx", "args": [ "@deepsrt/deepsrt-mcp@latest", "--server" ] } } }

或者让Cline在聊天中安装：

> “嘿，从以下位置为我安装此MCP服务器https://github.com/DeepSRT/deepsrt-mcp"

### 选项5：使用bunx（直接执行）

您可以直接使用bunx运行服务器，无需安装：

Run from the project directory

bunx --bun src/index.ts

Or use npm scripts

npm run start:bun # Uses Bun npm run start:node # Uses Node.js npm run dev # Development mode with Bun

## 用法

### MCP集成

服务器为MCP客户端提供以下工具：

### get_summary

获取YouTube视频的摘要。

**参数：**

- `videoId` （必填）：YouTube视频ID
- `lang` （可选）：语言代码（例如zh-tw）-默认为zh-tw
- `mode` （可选）：摘要模式（“叙述”或“项目符号”）-默认为叙述

### get_transcript

获取带有时间戳的YouTube视频的转录。

**参数：**

- `videoId` （必填）：YouTube视频ID或完整的YouTube URL
- `lang` （可选）：字幕的首选语言代码（例如，en、zh-tw）-默认为en

### 示例用法

使用克劳德桌面：

// Get video summary const summaryResult = await mcp.use_tool("deepsrt", "get_summary", { videoId: "dQw4w9WgXcQ", lang: "zh-tw", mode: "narrative" });

// Get video transcript const transcriptResult = await mcp.use_tool("deepsrt", "get_transcript", { videoId: "dQw4w9WgXcQ", lang: "en" });

使用Cline：

// Get video summary const summaryResult = await mcp.use_tool("deepsrt", "get_summary", { videoId: "dQw4w9WgXcQ", lang: "zh-tw", mode: "bullet" });

// Get video transcript const transcriptResult = await mcp.use_tool("deepsrt", "get_transcript", { videoId: "https://www.youtube.com/watch?v=dQw4w9WgXcQ", lang: "en" });

## 发展

安装依赖项：

npm install

### 运行测试

Run unit tests (fast, no network calls)

npm test

Run unit tests only

npm run test:unit

Run network tests (requires internet, may be slower)

npm run test:network

Run all tests including network tests

npm run test:all

Run tests in watch mode

npm run test:watch

Run tests with CI reporter (for CI/CD)

npm run test:ci

**测试类型：**

- **单元测试** (`src/index.test.ts`, `src/integration.test.ts`)-使用模拟数据进行快速测试
- **网络测试** (`src/transcript.test.ts`, `src/e2e.test.ts`)-真实的YouTube API集成测试

### 例子

请参阅 `examples/` 参考实现目录：

- `examples/standalone-summarizer.ts` -显示API直接使用模式的独立脚本

### 运行服务器

**使用Bun（建议用于开发-更快启动）：**

Development mode (runs TypeScript directly)

npm run dev

or

bun src/index.ts

Using npm script

npm run start:bun

**使用Node.js（生产环境）：**

Build first

npm run build

Then run

npm run start:node

or

node build/index.js

### 测试服务器

您可以使用MCP检查器测试服务器：

npm run inspector

或者使用JSON-RPC手动测试：

List available tools

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | bun src/index.ts

Test get_transcript

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_transcript", "arguments": {"videoId": "dQw4w9WgXcQ", "lang": "en"}}}' | bun src/index.ts

### 为生产而建

生产建设：

npm run build

开发观察模式：

npm run watch

## 演示

- https://www.threads.net/@工作/岗位/DGmIR7gOG5M
- https://www.threads.net/@pahud/post/DGoGiMDuWa9

## 常见问题解答

Q： 我得到了 `404` 错误，为什么？

A： 这是因为视频摘要未缓存在CDN边缘位置，您需要使用DeepSRT chrome扩展打开此视频，将其缓存在CDN网络中，然后才能使用MCP获取摘要。

您可以使用cURL验证缓存状态，如下所示

curl -s 'https://worker.deepsrt.com/transcript' \ -i --data '{"arg":"v=VafNvIcOs5w","action":"summarize","lang":"zh-tw","mode":"narrative"}' | grep -i "^cache-status" cache-status: HIT

如果你看到 `cache-status: HIT` 内容缓存在CDN边缘位置，您的MCP服务器不应获取 `404`.