bilibili-mcp
Enables AI assistants to operate Bilibili accounts and data through 27 tools: scan-code login and credential checks; search and crawl videos, comments, subtitles, and danmaku; publish videos, multi-part videos, dynamics, and opus articles; query zones, rankings, hot videos, and user profiles; and manage interactions such as replies, favorites, private messages, and notifications.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bilibili-mcpsearch bilibili for Python tutorials, sorted by most plays"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
bilibili-mcp
B站(Bilibili)MCP Server:让支持 MCP 的 AI 助手直接操作 B 站,27 个工具,覆盖登录、搜索采集、内容发布、数据分析、互动运营。
这是 adoresever/bilibili-mcp(MIT)的修改版,保留原作者的版权声明。 非官方项目,与哔哩哔哩无关,仅供学习研究。使用时请遵守 B 站的社区规则和用户协议。
和上游相比改了什么
详见 CHANGES.md。简要说:
改动 | 原因 |
扫码登录改读响应头 | 2026-10 起 B 站把 Cookie 从响应体挪到了响应头,上游和 |
| 一键附上创作者声明“该视频使用人工智能合成技术”,对应 |
新增 | 往投稿体里加 |
| 上游写死的对照有错(例如 208 是“校园学习”,不是“科技”) |
|
|
Related MCP server: Bilibili API MCP Server
验证状态(如实说明)
项目 | 状态 |
服务能启动,列出 27 个工具(stdio) | 已验证 |
扫码登录读 | 已验证(2026-10,用的是同样读法的诊断脚本) |
通过 | 未验证,只测到“等待扫码”这一步 |
| 已离线验证 |
真实上传 | 未验证,作者没有真实投稿过 |
AI 声明在服务端是否生效、是否展示 | 未验证 |
| 未验证。首次投稿后请自己到创作中心核对可见性 |
其余上游工具(搜索、评论、字幕、排行等) | 未重新测试,沿用上游 |
功能
登录认证
Tool | 功能 | 说明 |
| 扫码登录 | 生成二维码(base64 图片并保存为 |
| 登录状态检查 | 轮询扫码状态,成功后保存凭证 |
| 凭证验证 | 检查当前登录是否有效,返回用户名 |
数据采集
Tool | 功能 | 说明 |
| 搜索视频 | 按关键词搜索,支持按播放量/最新/弹幕排序 |
| 获取评论 | 获取视频热门评论,含子评论 |
| 获取字幕 | 获取视频 AI 字幕 |
| 获取弹幕 | 获取视频弹幕列表 |
| 视频详情 | 播放量、评论数、收藏数等 |
| 回复评论 | 发表评论或回复(支持楼中楼) |
| 批量采集 | 搜索 + 评论 + 字幕一步到位 |
内容发布
Tool | 功能 | 说明 |
| 发图文动态 | 文字 / 图文动态,支持定时发布、话题 |
| 上传视频 | 单 P 视频;本版新增 |
| 多 P 上传 | 多分 P 合并投稿;同样新增上面两个参数 |
| 图文专栏 | 发布图文长内容 |
| 分区查询 | 返回可投稿的主分区 → 子分区 ID |
数据分析
Tool | 功能 |
| 热门视频、热搜词、每周必看 |
| 全站及各分区排行榜 |
| UP 主信息和投稿列表 |
互动运营
Tool | 功能 |
| 收藏夹列表和内容 |
| 发私信 |
| 未读消息、收到的回复、@和点赞 |
bili_reply、bili_send_message、bili_send_dynamic 会真的发出内容,请谨慎,尤其是让 AI 自动调用时。
快速开始
需要 Python 3.10+。作者测试用的是 Python 3.14、bilibili-api-python 17.4.2、aiohttp 3.14、mcp 1.30。
git clone https://github.com/matkaparka/bilibili-mcp.git
cd bilibili-mcp
python -m venv .venv
.venv/bin/pip install -r requirements.txt # Windows: .venv\Scripts\pip登录
方式一:接入 MCP 后让 AI 调用 bili_login,把二维码给你扫,再调用 bili_login_check 直到返回 done。
方式二:命令行
.venv/bin/python bili_login.py # Windows: .venv\Scripts\python凭证保存在 bili_credential.json(已在 .gitignore 里)。不要提交它,也不要发给别人。 没有 refresh_token,过期后需要重新扫码。
注册到 MCP 客户端
Claude Code:在项目里建 .mcp.json,路径换成你自己的绝对路径。
{
"mcpServers": {
"bilibili-mcp": {
"command": "/path/to/bilibili-mcp/.venv/bin/python",
"args": ["/path/to/bilibili-mcp/mcp_server.py"]
}
}
}Windows 上写成 E:/path/to/bilibili-mcp/.venv/Scripts/python.exe。Cursor、Cline、Claude Desktop 等客户端的配置方式类似:command 填 Python,args 填 mcp_server.py 的完整路径。
用 MCP Inspector 测试:
npx @modelcontextprotocol/inspector .venv/bin/python mcp_server.py投稿的几个注意事项
调用
bili_upload_video时显式传tid,默认值 124 是“知识 → 社科·法律·心理”。可用bili_video_zones查可投稿的子分区。不传
cover_path时,工具会用ffmpeg从视频第 3 秒截封面,这要求 MCP 进程的 PATH 里有ffmpeg。不确定的话直接传cover_path。简介在页面参数上会被截到 250 字。
AI 生成的内容请保持
ai_declaration=True。第一次投稿建议同时传only_self=True,传完到创作中心确认可见性和声明都生效。
能在 DeepSeek 里用吗?
这个服务是标准的 stdio MCP 服务,不绑定任何模型。能不能“在 DeepSeek 里用”取决于你用的客户端:
DeepSeek 的网页和 App 本身不是 MCP 客户端,不能直接挂载。
Claude Code + DeepSeek 的 Anthropic 兼容接口:把 Claude Code 的后端指到 DeepSeek 即可,MCP 工具由 Claude Code 负责调用。环境变量写法(模型名按 DeepSeek 官方文档填,Token 不要写进仓库):
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key> export ANTHROPIC_MODEL=<DeepSeek 的模型名>其他支持 MCP、又能接 DeepSeek 的客户端(例如 Cline)原理相同。
作者没有在 DeepSeek 后端下验证过这些工具的调用是否稳定。 工具调用的质量取决于模型本身。建议先用只读工具(bili_check_credential、bili_search)试,确认没问题再让它投稿。
技术栈
bilibili-api-python:B 站 API 封装
文件
mcp_server.py MCP Server 主文件(27 个工具)
bili_login.py 命令行扫码登录
requirements.txt 依赖(mcp 限制在 <2)
CHANGES.md 相对上游的改动和验证状态
bili_credential.json 登录凭证(运行后生成,已被 .gitignore 忽略)许可证
MIT。原作者 AGI_Ananas 的版权声明保留,修改部分见 CHANGES.md。
This server cannot be deployed
Maintenance
Related MCP Connectors
YouTube transcripts, search, channel browsing, and playlists for AI agents via MCP.
Publish and schedule videos to TikTok, YouTube Shorts, Instagram, Facebook, LinkedIn, Pinterest, Bluesky, Threads and X from Claude, Cursor or any MCP client. Upload once, post everywhere, track views in unified analytics, and retry failed posts. Official platform APIs only, free plan available. Docs: https://docs.multi-upload-tool.com/mcp
Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.
TikTok research for AI agents: real TikTok search data, trends, videos, creators and comments in ChatGPT, Claude, Cursor, Codex or any MCP client. 45 tools. See what people search on TikTok each week (Creator Search Insights search volume and 7-day trends), find content gaps with no videos yet, check if a product is trending for TikTok Shop, analyze competitor creators and posts, read comments and replies, pull video transcripts, search hashtags and sounds, and pick fair giveaway winners. Built for marketers, agencies, TikTok Shop sellers and creators. Sign in with OAuth or an API key; 50 free credits.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Bilibili (B站) platform through API and web scraping. Supports video search, article search, video info retrieval, comment fetching, danmaku extraction, and article content access.4-
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Bilibili (哔哩哔哩) through its API, supporting video search and recommendations, user search, dynamic feeds, video collections, and danmaku retrieval through natural language.5-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to directly operate Bilibili, providing 27 tools for login, search, content publishing, data analysis, and interaction.105MIT
- AlicenseBqualityAmaintenanceEnables reading public Bilibili video information — keyword search, UP profiles and uploads, video details and parts, comments and replies, danmaku, subtitles, and frame snapshots — through an MCP interface, with optional Bilibili login for authenticated features such as comments and subtitles.162,222 PyPI2Apache 2.0