📺 bili-note-mcp

MCP-сервер для автоматического преобразования учебных видео с Bilibili в структурированные учебные конспекты.

Позволяет любому MCP-совместимому агенту (DSH, Claude Desktop, Cursor…) в один клик выполнить: видео Bilibili → извлечение субтитров → учебный конспект VitePress → сохранение на локальное устройство.

Это ваш опыт разработки по протоколу MCP для резюме: расширение агентов инструментами — самое горячее направление в современном AI-инжиниринге.

Зачем это

При подготовке к экзаменам больше всего времени занимает не «просмотр видео», а «составление конспектов». Этот MCP-сервер упаковывает весь процесс в инструменты, пригодные для вызова агентом:

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

В список insert в cordis.patch.yml добавьте:

- 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 агент сможет вызывать инструменты серии 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 SDK для Python; декоратор @mcp.tool автоматически генерирует схему инструмента

• Приоритет — без Cookie: AI-субтитры идут через публичный интерфейс, авторские субтитры требуют Cookie от авторизованного пользователя (опционально)

• Временная ссылка на субтитры: действует около 15 минут; при ошибке автоматически перебираются следующие дорожки

• Можно тестировать офлайн: основная логика (парсинг BV / таймкоды / структура конспекта) не зависит от внешних API

Известные ограничения (проверено)

• Субтитры требуют входа: Bilibili проверяет логин в интерфейсе субтитров (/x/player/wbi/v2), поэтому без Cookie большинство видео возвращает «нет доступных субтитров». Способы решения:

  1. Скопируйте Cookie из браузера (SESSDATA и др.) и передайте их в bili_get_transcript(cookies=...)

  2. Или сначала получите временный URL субтитров через браузер (действителен около 15 минут), затем напрямую вызывайте fetch_subtitle_json

  3. Метаданные видео (название / автор / длительность) доступны без Cookie — проверено ✅

Для резюме

• Разработан MCP-сервер, демонстрирующий навык расширения агентов инструментами

• Реально работает для подготовки к экзаменам: курсы на Bilibili → автоматические конспекты, пользуюсь ежедневно

• FastMCP + стандартная библиотека, без тяжёлых фреймворков, читаемый код

Лицензия

MIT © 2026 wpc7255625-dotcom