Deepsrt

🚀 DeepSRT MCP 服務器

DeepSRT MCP 服務器是一個與 DeepSRT API 集成的模型上下文協議（MCP）服務器，它能夠為 YouTube 視頻生成摘要，為用戶快速獲取視頻核心內容提供便利。

🚀 快速開始

要使用 DeepSRT MCP 服務器，你可以按照以下步驟進行操作：

安裝

為 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. 獲取並查看生成的中文摘要

✨ 主要特性

• 摘要生成：能夠生成 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

📚 詳細文檔

常見問題解答

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 錯誤。