金大哥 - DeepSRT MCP 详情

article

README

🚀 DeepSRT MCP 服务器

DeepSRT MCP 服务器是一个与 DeepSRT API 集成的模型上下文协议（MCP）服务器，主要用于生成 YouTube 视频的摘要，为用户提供便捷的视频内容获取方式。

✨ 主要特性

摘要生成：能够生成 YouTube 视频的摘要，满足用户快速了解视频内容的需求。
双模式支持：支持叙述和要点两种摘要模式，用户可根据自身喜好选择。
多语言适配：支持多语言，默认语言为 zh-tw，方便不同地区的用户使用。
无缝集成：可与 MCP 启用环境无缝集成，提升使用的便利性。

📚 详细文档

工作原理

内容缓存
- 需先通过 DeepSRT 打开视频，以确保内容在服务中被缓存。此初始观看操作会触发 DeepSRT 服务的内容缓存过程。
MCP 摘要检索
- 当通过 MCP 请求摘要时，内容将从 DeepSRT 的 CDN 边缘位置提供，确保摘要能够快速高效地交付。
预缓存内容
- 部分视频可能因之前用户的请求而被预缓存到系统中。虽然可能为这些预缓存的视频获取摘要，但可用性无法保证。为获得最佳效果，建议先通过 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 安装

首先构建服务器：

npm install
npm run build

将服务器配置添加到你的 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 浏览器安装

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

💻 使用示例

通过命令行使用 MCP 服务器

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

通过 Chrome 扩件使用

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

📚 常见问题解答

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 错误。

DeepSRT