📺 bili-note-mcp

B站コース動画を構造化された学習ノートへ自動変換する MCP サーバーです。

MCP をサポートする Agent（DSH、Claude Desktop、Cursor…）なら誰でもワンクリックで完了できます： B站動画 → 字幕抽出 → VitePress 学習ノート → ローカル保存。

これは履歴書に書ける MCP プロトコル開発 の経験です。Agent のツール拡張は、現在の AI エンジニアリングで最も人気のある分野です。

なぜ作るのか

試験勉強で最も時間がかかるのは「動画を見る」ことではなく「ノートを整理する」ことです。この MCP サーバーは、その一連の流れを Agent が呼び出せるツールとしてカプセル化しています：

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

Related MCP server: Open CLAW Knowledge Distiller

クイックスタート

# 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 への設定

cordis.patch.yml の insert リストに追加：

- 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

DSH を再起動すると、Agent は bili_* シリーズのツールを呼び出せるようになります。

MCP ツール一覧

ディレクトリ構造

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

技術の要点

• FastMCP プロトコル：公式 MCP Python SDK の高レベルラッパー。@mcp.tool デコレータが自動でツールのスキーマを生成します。

• Cookie 不要を優先：AI 字幕は公共インターフェースを使用。人力字幕は Cookie でのログインが必要です（任意）。

• 字幕の一時リンク：約 15 分有効。失敗したら自動的に次のトラックを試します。

• オフラインでテスト可能：中核ロジック（BV 解析 / タイムスタンプ / ノート構造）は外部 API に依存しません。

既知の制限（実測）

• 字幕トラックにはログイン状態が必要：B站 は字幕インターフェース（/x/player/wbi/v2）にログイン検証を設定しており、Cookie を持っていないと多くの動画で「利用可能な字幕なし」が返されます。解決方法：

  1. ブラウザから Cookie（SESSDATA など）をコピーして、bili_get_transcript(cookies=...) に渡す。

  2. または、先にブラウザで字幕の一時 URL（約 15 分有効）を取得し、直接 fetch_subtitle_json を呼び出す。

  3. 動画のメタ情報（タイトル / UP主 / 再生時間）は Cookie なしで取得可能です（検証済み ✅）。

履歴書でのアピール

• MCP プロトコルサーバーを開発し、Agent ツール拡張 の能力をアピールできます。

• 実サービスとして勉強対策の場面で運用：B站 のコース動画 → 自動ノート。自分で毎日使っています。

• FastMCP + 標準ライブラリのみ、重いフレームワークなし、コードは読みやすい。

ライセンス

MIT © 2026 wpc725562-dotOnCm