📺 bili-note-mcp

Servidor MCP que convierte automáticamente videos de cursos de Bilibili en notas de estudio estructuradas.

Permite que cualquier agente compatible con MCP (DSH, Claude Desktop, Cursor…) haga todo con un solo clic: Videos de Bilibili → extracción de subtítulos → notas de aprendizaje VitePress → guardado en local.

Esta es tu experiencia en desarrollo del protocolo MCP para el currículum: la extensión de herramientas para agentes es la dirección más demandada en la ingeniería de IA actual.

Por qué hacerlo

Lo que más tiempo toma al preparar exámenes no es “ver videos”, sino “organizar notas”. Esta es una de las MCP servers empaqueta todo el proceso como herramientas que el agente puede invocar:

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

Related MCP server: Open CLAW Knowledge Distiller

Inicio rápido

# 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

Configurar en DSH

En la lista insert de cordis.patch.yml, añade:

- 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

Después de reiniciar DSH, el agente podrá usar las herramientas de la familia bili_*.

Lista de herramientas MCP

Estructura de directorios

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

Puntos técnicos

• Protocolo FastMCP: capa de alto nivel sobre el SDK oficial de MCP para Python; el decorador @mcp.tool genera automáticamente el schema de la herramienta.

• Prioridad sin cookies: los subtítulos IA usan la interfaz pública; los subtítulos hechos por humanos requieren cookie de sesión (opcional).

• Enlaces temporales de subtítulos: son válidos unos 15 minutos; si fallan, se intenta automáticamente la siguiente pista.

• Comprobable sin conexión: la lógica principal (parsing de BV, marcas de tiempo, estructura de notas) no depende de APIs externas.

Limitaciones conocidas (comprobadas)

• Las pistas de subtítulos requieren inicio de sesión: Bilibili valida el login en la API de subtítulos (/x/player/wbi/v2); sin incluir cookies, la mayoría de los videos devuelven “no hay subtítulos disponibles”. Soluciones:

  1. Copiar la cookie del navegador (SESSDATA, etc.), y pasarla a bili_get_transcript(cookies=...).

  2. Obtener primero la URL temporal de los subtítulos desde el navegador (válido unos 15 minutos) y llamar directamente a fetch_subtitle_json.

  3. Los metadatos del video (título / UP主 / duración) funcionan sin cookie, verificado ✅

Aspectos destacados para el currículum

• Desarrollo de un servidor del protocolo MCP, mostrando la capacidad de extensión de herramientas para agentes.

• En uso real para preparación de exámenes: cursos de Bilibili → notas automáticas, y lo uso yo mismo todos los días.

• FastMCP + biblioteca estándar, sin frameworks pesados, código legible.

Licencia

MIT © 2026 wpc725562-dotcom