polylens-bilibili-mcp
读取 B 站视频、评论、字幕等公开信息的 MCP 服务，支持用 jq 在返回前筛选和裁剪结果，可本地运行，也可通过 HTTP + OAuth 远程接入。只读，不向平台写入任何数据。
工具
| 工具 | 说明 |
|---|---|
search_videos |
按关键词搜索视频，每批 30 条，最多 30 页 |
suggest_keywords |
搜索框联想词 |
get_feed |
首页推荐流，每批 30 条 |
get_up_info |
UP 主资料：签名、粉丝、获赞、等级、认证等，可一次查多个 |
list_up_videos |
UP 主投稿，每批最多 40 条，可按最新、播放、收藏排序 |
get_video_info |
标题、作者、发布时间、简介与各项统计，可一次查多个视频或分 P |
get_parts |
分 P 清单，可一次查多个视频 |
get_danmaku_counts |
每个分 P 的弹幕数，可一次查多个视频，?p=1-12 取指定范围 |
get_comments |
主评论，热度序或时间序，游标续取 |
get_comment_replies |
某条主评论下的二级评论 |
get_subtitles |
逐句字幕，含起止秒数，可指定语种 |
start_qr_login · complete_qr_login |
扫码登录 |
get_login_status · logout |
查询登录状态、退出登录 |
get_version |
运行中的版本与 PyPI 最新版本，用于判断工具说明是否为旧缓存、服务是否需要升级；传 since 可查之后的用法变化 |
登录
除登录相关工具与 get_version 外都需要登录，每次调用前联网核验登录状态。start_qr_login 返回二维码，用 B 站 App 扫码确认后，由 complete_qr_login 完成登录。凭据保存在 ~/.cache/polylens-bilibili/cookie（设置了 XDG_CACHE_HOME 时位于其下），logout 会删除它。
用 jq 精简返回
search_videos、list_up_videos、get_feed、get_video_info、get_up_info、get_parts、get_danmaku_counts、get_comments、get_comment_replies、get_subtitles 必须传 jq 参数，在返回前筛选条目或裁剪字段，减少上下文占用。表达式由模型自行编写，传 . 则原样返回，例如：
| 用途 | 表达式 |
|---|---|
| 字幕只要文本 | map(.content) | join("\n") |
| 只看第 10 到 15 分钟的字幕 | [.[] | select(.start >= 600 and .start < 900)] |
| 搜索结果只留高播放量 | [.[] | select(.view_count > 100000) | {title, url, view_count}] |
安装
需要 uv，没有 Python 3.13+ 时 uv 会自动下载。
接入 Claude Code：
claude mcp add polylens-bilibili -- uvx polylens-bilibili-mcp
接入 Claude Desktop，在 claude_desktop_config.json 中加入：
{
"mcpServers": {
"polylens-bilibili": {
"command": "uvx",
"args": ["polylens-bilibili-mcp"]
}
}
}
升级：重启客户端，uvx 启动时会取最新版本。
从源码运行
git clone https://github.com/liu-xindi/polylens-bilibili-mcp.git
cd polylens-bilibili-mcp && uv sync
claude mcp add polylens-bilibili -- uv run --directory /绝对路径/polylens-bilibili-mcp polylens-bilibili-mcp
升级：git pull && uv sync。
远程访问（HTTP + OAuth）
供 claude.ai 网页端或手机端以连接器接入。服务以 Streamable HTTP 运行并内置 OAuth，默认只监听本机，需由反向代理以 HTTPS 暴露到公网地址。
POLYLENS_BILIBILI_TRANSPORT=http \
POLYLENS_BILIBILI_PUBLIC_URL=https://example.com \
POLYLENS_BILIBILI_AUTH_SECRET='<口令>' \
uvx polylens-bilibili-mcp
然后在 claude.ai 添加连接器，URL 填 https://example.com/mcp，首次授权时在同意页输入上面的口令。
| 环境变量 | 命令行 | 默认 | 说明 |
|---|---|---|---|
POLYLENS_BILIBILI_TRANSPORT |
--transport |
stdio |
stdio 或 http |
POLYLENS_BILIBILI_HTTP_HOST |
--host |
127.0.0.1 |
监听地址 |
POLYLENS_BILIBILI_HTTP_PORT |
--port |
6622 |
监听端口 |
POLYLENS_BILIBILI_PUBLIC_URL |
--public-url |
无 | 公网地址 |
POLYLENS_BILIBILI_AUTH_SECRET |
无 | 无 | 机主口令 |
POLYLENS_BILIBILI_INSECURE_NO_AUTH |
无 | 否 | 关闭鉴权，仅限本机调试 |
命令行优先于环境变量。http 模式下公网地址和口令缺一则拒绝启动。开启 INSECURE_NO_AUTH=1 后任何能连到端口的人都能调用全部工具，包括使用已保存的登录凭据。
评论限速
平台会拦截频繁的请求，被拦后约 15 分钟恢复。为此：
- 评论每分钟最多 30 页，超出时排队等待。
- 被拦后评论工具停用 15 分钟，恢复后自动可用，其他工具不受影响。
- 评论结果按整次调用缓存：除 jq 外参数相同的调用直接返回缓存，不占额度，被拦期间也能返回。只缓存完整的结果，不设有效期，总量超过约 50 MB 时淘汰最久没用的，服务重启后清空。
- 弹幕数按分段缓存，与评论共用上述上限，
refresh重取。
免责声明与许可证
本工具供个人学习与研究使用。需要登录的功能以使用者本人的凭据，在其账号权限范围内访问，不绕过付费墙或内容保护。所获内容版权归原发布方，使用者须自行遵守法律、平台条款与版权规定，并承担使用后果。
以 Apache License 2.0 授权，按现状提供，不附任何担保。
1 maintainer
Metadata
1 maintainer
Release files for polylens-bilibili-mcp 0.9.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| polylens_bilibili_mcp-0.9.3.tar.gz | 148.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| polylens_bilibili_mcp-0.9.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 224.5 kB
Release files / polylens_bilibili_mcp-0.9.3.tar.gz
| Download URL | polylens_bilibili_mcp-0.9.3.tar.gz |
|---|---|
| Size | 148.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
895a1e4038a93c64a165cafe58b1429a0d3dcedffa967906bc12eb1280b72427
|
|
BLAKE2b-256 checksum How to use checksums |
e3229d3a4291c21abf619da7d7d9f4ea5c0896cfcd95d4072ca712fcb53192ae
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / polylens_bilibili_mcp-0.9.3-py3-none-any.whl
| Download URL | polylens_bilibili_mcp-0.9.3-py3-none-any.whl |
|---|---|
| Size | 76.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0efaef968572ea609e217570526003cbdb4c3c138d884017d60c34a0eebb3e90
|
|
BLAKE2b-256 checksum How to use checksums |
3652ed0e663f781a4e3085a4173aab98d73f9eadbaea1cef5f1b3b9fe122ad60
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
