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 | 无 | 否 | 关闭鉴权，仅限本机调试 | | POLYLENS_BILIBILI_PROXY | 无 | 无 | 取字幕用的 HTTP 代理，如 http://10.0.0.2:8888。平台对海外 IP 不返回字幕，部署在海外时需要设置；其余请求始终直连 |

命令行优先于环境变量。http 模式下公网地址和口令缺一则拒绝启动。开启 INSECURE_NO_AUTH=1 后任何能连到端口的人都能调用全部工具，包括使用已保存的登录凭据。

评论限速

平台会拦截频繁的请求，被拦后约 15 分钟恢复。为此：

• 评论每分钟最多 30 页，超出时排队等待。
• 被拦后评论工具停用 15 分钟，恢复后自动可用，其他工具不受影响。
• 评论结果按整次调用缓存：除 jq 外参数相同的调用直接返回缓存，不占额度，被拦期间也能返回。只缓存完整的结果，不设有效期，总量超过约 50 MB 时淘汰最久没用的，服务重启后清空。
• 弹幕数按分段缓存，与评论共用上述上限，refresh 重取。

免责声明与许可证

本工具供个人学习与研究使用。需要登录的功能以使用者本人的凭据，在其账号权限范围内访问，不绕过付费墙或内容保护。所获内容版权归原发布方，使用者须自行遵守法律、平台条款与版权规定，并承担使用后果。

以 Apache License 2.0 授权，按现状提供，不附任何担保。