DeepSRT MCP 服务器

一个通过与 DeepSRT API 集成提供 YouTube 视频摘要功能的模型上下文协议 (MCP) 服务器。

功能

• 生成 YouTube 视频的摘要
• 支持叙述和要点两种摘要模式
• 多语言支持（默认：zh-tw）
• 与 MCP 启用环境无缝集成

工作原理

1. 内容缓存

   • 必须首先通过 DeepSRT 打开视频以确保内容在服务中被缓存
   • 这个初始观看会触发 DeepSRT 服务中的内容缓存过程

2. MCP 摘要检索

   • 当通过 MCP 请求摘要时，内容将从 DeepSRT 的 CDN 边缘位置提供
   • 确保快速高效地交付摘要

3. 预缓存内容

   • 部分视频可能已经因为之前用户的请求而被预缓存到系统中
   • 虽然你可能能够为这些预缓存的视频获取摘要，但可用性不能保证
   • 为了获得最佳效果，请确保首先通过 DeepSRT 打开视频

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#2496ED', 'secondaryColor': '#38B2AC', 'tertiaryColor': '#1F2937', 'mainBkg': '#111827', 'textColor': '#E5E7EB', 'lineColor': '#4B5563', 'noteTextColor': '#E5E7EB'}}}%%
sequenceDiagram
    participant 用户
    participant DeepSRT
    participant Cache as DeepSRT 缓存/CDN
    participant MCP 作为 MCP 客户端

    Note over 用户,MCP: 步骤 1：初始缓存
    用户->>DeepSRT: 通过 DeepSRT 打开视频
    DeepSRT->>Cache: 处理并缓存内容
    Cache-->>DeepSRT: 确认缓存存储
    DeepSRT-->>用户: 显示视频/内容

    Note over 用户,MCP: 步骤 2：MCP 摘要检索
    MCP->>Cache: 通过 MCP 请求摘要
    Cache-->>MCP: 从边缘位置返回缓存的摘要

    Note over 用户,MCP: 替代方案：预缓存内容
    rect rgba(31, 41, 55, 0.6)
        MCP->>Cache: 请求预缓存视频的摘要
        alt 内容存在于缓存中
            Cache-->>MCP: 返回缓存的摘要
        else 内容未被缓存
            Cache-->>MCP: 缓存未命中
        end
    end

安装

为 Claude Desktop 安装

1. 首先构建服务器：

npm install
npm run build

2. 将服务器配置添加到你的 Claude Desktop 配置文件中：

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

{
  "mcpServers": {
    "deepsrt-mcp": {
      "command": "node",
      "args": [
        "/path/to/deepsrt-mcp/build/index.js"
      ]
    }
  }
}

为 Chrome 浏览器安装

1. 访问 Chrome Web Store
2. 安装 DeepSRT 扩展
3. 按照扩展中的说明完成配置

使用方法

通过命令行使用 MCP 服务器

curl -X POST http://localhost:3000 \
     -H "Content-Type: application/json" \
     -d '{"video_id":"VafNvIcOs5w", "lang":"zh-tw", "mode":"narrative"}'

通过 Chrome 扩件使用

1. 打开需要获取摘要的 YouTube 视频
2. 点击 DeepSRT 扩展图标
3. 在扩展界面中输入视频 ID 或直接使用当前页面
4. 获取并查看生成的中文摘要

常见问题解答

Q: 我遇到了 404 错误，为什么？

A: 这是因为视频摘要尚未在 CDN 边缘位置缓存。你需要先通过 DeepSRT 浏览器扩展打开该视频，以便其被缓存到 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，则表示内容已经在 CDN 边缘位置缓存，此时 MCP 服务器不应返回 404 错误。