📺 bili-note-mcp

Bilibili 강좌 영상을 구조화된 학습 노트로 자동 변환하는 MCP 서버입니다.

MCP를 지원하는 모든 Agent(DSH, Claude Desktop, Cursor…)가 한 번에 다음을 완료할 수 있습니다: Bilibili 동영상 → 자막 추출 → 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 데코레이터가 도구 스키마를 자동 생성합니다.

• 쿠키 불필요 우선: AI 자막은 공개 인터페이스를 사용하며, 수동 자막은 로그인 쿠키가 필요합니다(선택).

• 자막 임시 링크: 약 15분 동안 유효하며, 실패 시 다음 트랙을 자동으로 시도합니다.

• 오프라인 테스트 가능: 핵심 로직(BV 파싱/타임스탬프/노트 구조)은 외부 API에 의존하지 않습니다.

알려진 제한 사항 (실측)

• 자막 트랙은 로그인 상태가 필요: Bilibili는 자막 인터페이스(/x/player/wbi/v2)에 로그인 검증을 하며, 쿠키가 없으면 대부분의 동영상이 "사용 가능한 자막 없음"을 반환합니다. 해결 방법:

  1. 브라우저에서 쿠키(SESSDATA 등)를 복사해 bili_get_transcript(cookies=...)에 전달합니다.

  2. 또는 먼저 브라우저에서 자막 임시 URL(약 15분 유효)을 확보한 뒤 fetch_subtitle_json을 직접 호출합니다.

  3. 동영상 메타 정보(제목/크리에이터/길이)는 쿠키 없이 사용 가능하며, 검증 완료 ✅

이력서 강점

• MCP 프로토콜 서버를 개발하여 Agent 도구 확장 역량을 보여줍니다.

• 실제 시험 준비 시나리오에 적용: Bilibili 강좌 → 자동 노트, 직접 매일 사용합니다.

• FastMCP + 표준 라이브러리, 무거운 프레임워크 없는 읽기 쉬운 코드.

라이선스

MIT © 2026 wpc725562-dotcom