📺 bili-note-mcp

Ein MCP-Server, der B站-Kursvideos automatisch in strukturierte Lernnotizen umwandelt.

So kann jeder MCP-fähige Agent (DSH, Claude Desktop, Cursor …) mit einem Klick: B站-Video → Untertitel extrahieren → VitePress-Lernnotizen → lokal speichern.

Das ist deine MCP-Protokoll-Entwicklungs-Erfahrung für den Lebenslauf: Agent-Tool-Erweiterung ist aktuell der heißeste Bereich im KI-Engineering.

Warum dieses Projekt

Bei der Prüfungsvorbereitung ist nicht das „Anschauen des Videos“ am zeitaufwendigsten, sondern das „Erstellen strukturierter Notizen“. Dieser MCP-Server kapselt den gesamten Ablauf in von Agenten aufrufbare Werkzeuge:

Agent 说"把鹏哥C语言 P117 的字幕做成笔记"
   └─→ bili_get_transcript(BV17a7K64ELH)   ← 提取字幕（带时间戳）
   └─→ bili_generate_note(...)              ← 转结构化笔记（要点/Active Recall/分段）
   └─→ bili_save_note(...)                  ← 保存到 VitePress 笔记目录

Related MCP server: Open CLAW Knowledge Distiller

Schnellstart

# 1. 安装依赖
pip install 'mcp[cli]'

# 2. 测试（离线，不连 B站）
python tests/test_bili_note.py

# 3. 手动验证字幕提取（用任意 BV 号）
python -m tools.bili_subtitle BV17a7K64ELH

# 4. 启动 MCP 服务器（stdio 模式）
python server.py

DSH konfigurieren

Füge in die insert-Liste der cordis.patch.yml Folgendes hinzu:

- id: mcp-client-bili-note
  name: '@huiliyi37/dsh-mcp-client'
  config:
    transport: stdio
    serverName: bili-note
    command: 'python'
    args: ['C:\Users\Administrator\Desktop\deeepseek\bili-note-mcp\server.py']
    toolCallTimeoutMs: 120000
    failOnStartupError: false

Nach dem Neustart von DSH kann der Agent die bili_*-Werkzeugreihe aufrufen.

MCP-Werkzeugliste

Verzeichnisstruktur

bili-note-mcp/
├── server.py              # MCP 服务器入口（FastMCP）
├── tools/
│   ├── bili_subtitle.py   # B站 API 字幕提取
│   ├── bili_search.py     # B站视频搜索
│   └── note_generator.py  # 字幕 → VitePress 笔记
├── tests/
│   └── test_bili_note.py  # 离线测试
├── examples/
├── AGENTS.md
└── README.md

Technische Schwerpunkte

• FastMCP-Protokoll: Offizielles-Qualitäts-Wrapper des MCP-Python-SDK; der @mcp.tool-Dekorator generiert automatisch das Tool-Schema

• Bevorzugt ohne Cookie: KI-Untertitel laufen über die universellen Schnittstelle; manuelle Untertitel erfordern (optional) ein Login-Cookie

• Temporäre Untertitel-Links: ca. 15 Minuten gültig, bei Fehler wird automatisch die nächste Spur versucht

• Offline testbar: Kernlogik (BV-Parsing/Zeitstempel/Notizstruktur) ist nicht von externen APIs abhängig

Bekannte Einschränkungen (pratkWirksam getestet)

• Untertitel-Spuren erfordern einen Anmeldestatus: B站 führt für die Untertitel-Schnittstelle (/x/player/wbi/v2) eine Anmeldeprüfung durch; ohne Cookie liefern die meisten Videos „keine verfügbaren Untertitel“ zurück. Lösungen:

  1. Cookie aus dem Browser kopieren (SESSDATA usw.) und an bili_get_transcript(cookies=...) übergeben

  2. Oder zuerst im Browser die temporäre Untertitel-URL abrufen (ca. 15 Minuten gültig) und direkt fetch_subtitle_json aufrufen

  3. Die Video-Metadaten (Titel/Uploader/Deckungsanteil) sind ohne Cookie nutzbar – verifiziert ✅

Lebenslauf-Highlights

• Einen MCP-Protokoll-Server entwickelt und damit die Agent-Tool-Erweiterung gezeigt

• Originell dem Prüfungsalltag gedient: B站-Kurs → automatische Notizen, selbst täglich genutzt

• FastMCP + Standardbibliothek, kein Hochlast-Framework, lesbarer Code

Lizenz

MIT © 2026 wpc725562-dotcom