@xzxzzx/bilibili-mcp 1.5.3 → 1.6.1

package/README.md

@@ -6,7 +6,7 @@
 
 Bilibili MCP server — 让 Claude、Cursor、Codex 等 AI 客户端直接读取 Bilibili 视频字幕、转录、元数据和热门评论的 MCP server。
 
-🌐 [English Documentation](https://github.com/XZXZZX-Ai/bilibili-mcp/blob/master/README_EN.md) · 📜 [更新日志](https://github.com/XZXZZX-Ai/bilibili-mcp/blob/master/CHANGELOG.md) · 📦 [npm](https://www.npmjs.com/package/@xzxzzx/bilibili-mcp) · 🚀 [Release v1.5.3](https://github.com/XZXZZX-Ai/bilibili-mcp/releases/tag/v1.5.3)
+🌐 [English Documentation](https://github.com/XZXZZX-Ai/bilibili-mcp/blob/master/README_EN.md) · 📜 [更新日志](https://github.com/XZXZZX-Ai/bilibili-mcp/blob/master/CHANGELOG.md) · 📦 [npm](https://www.npmjs.com/package/@xzxzzx/bilibili-mcp) · 🚀 [Release v1.6.1](https://github.com/XZXZZX-Ai/bilibili-mcp/releases/tag/v1.6.1)
 
 > [!TIP]
 > ⚠️ 你可以把下方“用 agent 工具帮你安装”的提示词复制给 Codex、Claude Code、Cursor 等 agent，让它帮你完成 MCP 客户端接入和 Cookie 配置引导。为了稳定获取字幕、转录和评论，安装后仍需配置 B 站 Cookie(agent会引导你)；不要把 Cookie 写进 MCP 客户端配置。Metadata 可能无需 Cookie。详见 [**凭证配置**](#️-凭证配置)。
@@ -29,15 +29,15 @@ Bilibili MCP server — 让 Claude、Cursor、Codex 等 AI 客户端直接读取
 MCP server 配置要求：
 - server 名称：bilibili-mcp
 - command：npx
-- args：["-y", "@xzxzzx/bilibili-mcp"]
+- args：["-y", "@xzxzzx/bilibili-mcp@latest"]
 
 不要把真实 Bilibili Cookie 写入 MCP 客户端配置文件、客户端配置里的 env 字段、args 或聊天消息中。
 添加 MCP server 后，请继续引导我单独运行下面的命令，把 Cookie 保存到本机凭证配置；MCP server 启动后会自动读取这些凭证：
 
-npx -y @xzxzzx/bilibili-mcp config
-npx -y @xzxzzx/bilibili-mcp check
+npx -y @xzxzzx/bilibili-mcp@latest config
+npx -y @xzxzzx/bilibili-mcp@latest check
 
-连接 MCP server 后，如可用，请调用 get_credential_setup_instructions 或 check_bilibili_credentials，确认我完成 Cookie 配置。
+连接 MCP server 后，如可用，请调用 get_credential_setup_instructions、check_bilibili_credentials 或 check_mcp_update，确认我完成 Cookie 配置并了解包版本更新状态。
 ```
 
 - [Codex app / Codex CLI](#codex-app--codex-cli)
@@ -136,6 +136,7 @@ npx -y @xzxzzx/bilibili-mcp check
 
 - `get_credential_setup_instructions`: 返回安全的 Bilibili Cookie 配置命令和说明。AI agent 安装此 MCP 后可调用此工具引导用户完成配置。
 - `check_bilibili_credentials`: 检查凭证是否已配置并处于登录状态，不返回任何 Cookie 值。配置缺失或失效时返回下一步操作指引。
+- `check_mcp_update`: 检查本地包版本与 npm latest 是否一致，并返回 `npx @latest` 或全局安装的安全更新指引。
 
 ### 6. 行为说明与错误处理
 
@@ -176,15 +177,17 @@ npx -y @xzxzzx/bilibili-mcp check
 > 不要在 MCP 客户端配置文件中写入真实 Cookie。建议先用 `bilibili-mcp config` 保存到本机凭证配置，或在运行环境中提供环境变量；MCP server 启动后会自动读取这些凭证。详见 [⚙️ 凭证配置](#️-凭证配置)。
 
 > [!IMPORTANT]
-> 如果你是正在帮用户安装本 MCP 的 AI agent：不要只写入 MCP 配置就结束。添加 `bilibili-mcp` server 后，必须继续提醒并引导用户完成 Bilibili Cookie 配置。连接 MCP server 后，agent 也可调用 `get_credential_setup_instructions` 或 `check_bilibili_credentials` 工具来引导用户。
+> 如果你是正在帮用户安装本 MCP 的 AI agent：不要只写入 MCP 配置就结束。添加 `bilibili-mcp` server 后，必须继续提醒并引导用户完成 Bilibili Cookie 配置。连接 MCP server 后，agent 也可调用 `get_credential_setup_instructions`、`check_bilibili_credentials` 或 `check_mcp_update` 工具来引导用户。
 >
 > 推荐引导用户运行：
 >
 > ```bash
-> npx -y @xzxzzx/bilibili-mcp config
-> npx -y @xzxzzx/bilibili-mcp check
+> npx -y @xzxzzx/bilibili-mcp@latest config
+> npx -y @xzxzzx/bilibili-mcp@latest check
 > ```
 >
+> MCP 客户端配置推荐使用 `npx -y @xzxzzx/bilibili-mcp@latest`，这样新的客户端会话会解析当前 npm release。已经全局安装的用户需要手动运行 `npm install -g @xzxzzx/bilibili-mcp@latest` 更新，也可以用 `bilibili-mcp check-update` 检查版本状态。
+>
 > 如果用户已经全局安装，也可以使用：
 >
 > ```bash
@@ -203,12 +206,12 @@ Codex app、Codex CLI 和 Codex IDE extension 共用 MCP 配置。优先使用
 打开 Settings → Integrations & MCP，添加自定义 MCP server：
 
 - Command: `npx`
-- Arguments: `["-y", "@xzxzzx/bilibili-mcp"]`
+- Arguments: `["-y", "@xzxzzx/bilibili-mcp@latest"]`
 
 #### Codex CLI
 
 ```bash
-codex mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
+codex mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp@latest
 ```
 
 配置后，在 Codex CLI TUI 中运行 `/mcp` 查看 server 状态。
@@ -223,13 +226,13 @@ codex mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
 ```toml
 [mcp_servers.bilibili-mcp]
 command = "npx"
-args = ["-y", "@xzxzzx/bilibili-mcp"]
+args = ["-y", "@xzxzzx/bilibili-mcp@latest"]
 ```
 
 ### Claude Code
 
 ```bash
-claude mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
+claude mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp@latest
 ```
 
 默认会作为当前项目的本地 MCP server 保存。配置后可在 Claude Code 中运行 `/mcp`，或在终端运行 `claude mcp list` 检查连接状态。
@@ -237,7 +240,7 @@ claude mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
 如果希望所有项目都可用，可使用用户级 scope：
 
 ```bash
-claude mcp add --scope user bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
+claude mcp add --scope user bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp@latest
 ```
 
 也可以手动编辑 `~/.claude.json`，在对应项目或用户配置下添加与 Claude Desktop 相同的 JSON。
@@ -257,7 +260,7 @@ claude mcp add --scope user bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -275,7 +278,7 @@ claude mcp add --scope user bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
   "mcp": {
     "bilibili-mcp": {
       "type": "local",
-      "command": ["npx", "-y", "@xzxzzx/bilibili-mcp"],
+      "command": ["npx", "-y", "@xzxzzx/bilibili-mcp@latest"],
       "enabled": true
     }
   }
@@ -289,7 +292,7 @@ OpenCode 会把 MCP tools 加入可用工具上下文。使用时可在提示词
 使用 OpenClaw 的 MCP registry 注册本服务：
 
 ```bash
-openclaw mcp set bilibili-mcp '{"command":"npx","args":["-y","@xzxzzx/bilibili-mcp"]}'
+openclaw mcp set bilibili-mcp '{"command":"npx","args":["-y","@xzxzzx/bilibili-mcp@latest"]}'
 ```
 
 检查配置：
@@ -307,7 +310,7 @@ openclaw mcp show bilibili-mcp
     "servers": {
       "bilibili-mcp": {
         "command": "npx",
-        "args": ["-y", "@xzxzzx/bilibili-mcp"]
+        "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
       }
     }
   }
@@ -324,7 +327,7 @@ openclaw mcp show bilibili-mcp
 mcp_servers:
   bilibili-mcp:
     command: "npx"
-    args: ["-y", "@xzxzzx/bilibili-mcp"]
+    args: ["-y", "@xzxzzx/bilibili-mcp@latest"]
 ```
 
 如果你已经在运行 Hermes 会话，使用 `/reload-mcp` 重新加载 MCP 配置；也可以开启一个新的 Hermes 会话。
@@ -357,7 +360,7 @@ Cursor 编辑器和 Cursor CLI (`cursor-agent`) 共用同一套 `mcp.json` 配
     "bilibili-mcp": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -387,7 +390,7 @@ Cline 支持本地 STDIO 和远程 MCP。编辑 Cline MCP 配置文件，加入
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"],
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"],
       "disabled": false,
       "autoApprove": []
     }
@@ -420,7 +423,7 @@ Kilo Code 的 MCP server 写在主配置文件的 `mcp` 对象下。
   "mcp": {
     "bilibili-mcp": {
       "type": "local",
-      "command": ["npx", "-y", "@xzxzzx/bilibili-mcp"],
+      "command": ["npx", "-y", "@xzxzzx/bilibili-mcp@latest"],
       "enabled": true,
       "timeout": 10000
     }
@@ -452,7 +455,7 @@ MCP: Open Workspace Folder MCP Configuration
     "bilibili-mcp": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -482,7 +485,7 @@ GitHub Copilot Chat 在 VS Code 中读取 VS Code MCP 配置。工作区配置
     "bilibili-mcp": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -500,7 +503,7 @@ WorkBuddy 官方文档推荐通过界面配置 MCP。进入侧边栏 插件 →
     "bilibili-mcp": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -518,7 +521,7 @@ WorkBuddy 官方文档推荐通过界面配置 MCP。进入侧边栏 插件 →
 CodeBuddy CLI 可以直接添加 stdio MCP server：
 
 ```bash
-codebuddy mcp add --scope user bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
+codebuddy mcp add --scope user bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp@latest
 ```
 
 检查配置：
@@ -538,7 +541,7 @@ codebuddy mcp get bilibili-mcp
     "bilibili-mcp": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"],
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"],
       "description": "Bilibili MCP server"
     }
   }
@@ -564,7 +567,7 @@ codebuddy mcp get bilibili-mcp
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -583,7 +586,7 @@ codebuddy mcp get bilibili-mcp
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -602,7 +605,7 @@ Trae SOLO CN 是 Trae 中国版的 SOLO 工作方式。官方公开文档没有
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -621,7 +624,7 @@ Trae SOLO International 已存在，官方 FAQ 说明国际版 SOLO 面向 Pro
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -642,7 +645,7 @@ Qoder 有多种形态，MCP 入口略有不同：Qoder IDE 在设置页配置，
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -655,7 +658,7 @@ Qoder 文档说明 Streamable HTTP 可按 SSE endpoint 方式配置并自动检
 Qoder CLI 可直接添加 stdio MCP server：
 
 ```bash
-qodercli mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
+qodercli mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp@latest
 ```
 
 常用检查命令：
@@ -683,7 +686,7 @@ qodercli mcp list
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -692,7 +695,7 @@ qodercli mcp list
 也可以选择 Fill in Config Manually，Server Type 选择 STDIO：
 
 - Server Name: `bilibili-mcp`
-- Command: `npx -y @xzxzzx/bilibili-mcp`
+- Command: `npx -y @xzxzzx/bilibili-mcp@latest`
 
 添加后在 Custom Servers 中确认 server 已启用，并展开查看可用 tools。不要在 Qoder / QoderWork 的 MCP 配置中写真实 Cookie；凭证请使用 `bilibili-mcp config` 或环境变量配置。
 
@@ -710,7 +713,7 @@ Kimi Code CLI 可作为 MCP client 连接本地 stdio server。当前 Kimi Code
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -728,7 +731,7 @@ Kimi Code CLI 可作为 MCP client 连接本地 stdio server。当前 Kimi Code
 旧版 Kimi CLI 文档也提供过 `kimi mcp add` 命令；如果你使用的安装版本仍支持该命令，可用：
 
 ```bash
-kimi mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
+kimi mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp@latest
 kimi mcp list
 kimi mcp test bilibili-mcp
 ```
@@ -754,7 +757,7 @@ Antigravity IDE 可通过 MCP Store → Manage MCP Servers → View raw config
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -783,7 +786,7 @@ pi install npm:pi-mcp-adapter
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -829,7 +832,7 @@ Oh My Pi (`omp`) 原生支持 MCP，优先使用 OMP 专属配置文件：
     "bilibili-mcp": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -870,7 +873,7 @@ Crush 支持项目级和用户级 JSON 配置，MCP server 写在 `mcp` 对象
     "bilibili-mcp": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -883,7 +886,7 @@ Crush 也支持 HTTP 和 SSE MCP。不要在 `env` 或 `args` 中写真实 Cooki
 DeepSeek-TUI 同时是 MCP client 和 MCP server。作为 MCP client 时，可用 `deepseek mcp add` 添加本项目：
 
 ```bash
-deepseek mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
+deepseek mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp@latest
 ```
 
 也可以编辑：
@@ -899,7 +902,7 @@ deepseek mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -916,7 +919,7 @@ Deep Code 使用 `~/.deepcode/settings.json` 配置 MCP server。把 `bilibili-m
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["@xzxzzx/bilibili-mcp"]
+      "args": ["@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -929,7 +932,7 @@ Deep Code 文档说明 `command` 为 `npx` 时会自动补充 `-y`。配置后
 Reasonix 支持原生 MCP。最简单的方式是启动时传入 `--mcp`：
 
 ```bash
-npx reasonix code --mcp "bilibili=npx -y @xzxzzx/bilibili-mcp"
+npx reasonix code --mcp "bilibili=npx -y @xzxzzx/bilibili-mcp@latest"
 ```
 
 也可以编辑全局配置：
@@ -943,7 +946,7 @@ npx reasonix code --mcp "bilibili=npx -y @xzxzzx/bilibili-mcp"
 ```json
 {
   "mcp": [
-    "bilibili=npx -y @xzxzzx/bilibili-mcp"
+    "bilibili=npx -y @xzxzzx/bilibili-mcp@latest"
   ]
 }
 ```
@@ -972,7 +975,7 @@ GitHub Copilot CLI 可在交互模式里使用 `/mcp add` 添加 MCP server。
     "bilibili-mcp": {
       "type": "local",
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"],
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"],
       "env": {},
       "tools": ["*"]
     }
@@ -991,7 +994,7 @@ Windsurf 的 MCP 由 Cascade 使用。官方入口是 Cascade 面板右上角的
 打开 MCP Marketplace 或 MCP Servers 设置后，添加自定义 stdio MCP server：
 
 - Command: `npx`
-- Arguments: `["-y", "@xzxzzx/bilibili-mcp"]`
+- Arguments: `["-y", "@xzxzzx/bilibili-mcp@latest"]`
 
 Windsurf 也支持 MCP deeplink；如果你在文档或网页中提供安装入口，可以使用 `windsurf://windsurf-mcp-registry?serverName=<server-name>` 打开对应 MCP registry 页面。
 
@@ -1010,7 +1013,7 @@ Windsurf 也支持 MCP deeplink；如果你在文档或网页中提供安装入
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -1043,7 +1046,7 @@ Zed 使用 `context_servers` 配置 MCP，不使用 `mcpServers`。可以通过
   "context_servers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -1081,7 +1084,7 @@ Settings → Default Agent → Plugin Settings → Custom Plugins → Quick JSON
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -1098,7 +1101,7 @@ AstrBot 通过 WebUI 管理 MCP。先确保 AstrBot 运行环境可使用 `npm`
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
     }
   }
 }
@@ -1122,7 +1125,7 @@ nanobot 的配置文件是：
     "mcpServers": {
       "bilibili-mcp": {
         "command": "npx",
-        "args": ["-y", "@xzxzzx/bilibili-mcp"]
+        "args": ["-y", "@xzxzzx/bilibili-mcp@latest"]
       }
     }
   }
@@ -1138,8 +1141,8 @@ nanobot 的 MCP 配置兼容 Claude Desktop / Cursor 风格；也支持远程 MC
 ### 推荐方式：让 agent 引导你配置
 
 ```bash
-npx -y @xzxzzx/bilibili-mcp config
-npx -y @xzxzzx/bilibili-mcp check
+npx -y @xzxzzx/bilibili-mcp@latest config
+npx -y @xzxzzx/bilibili-mcp@latest check
 ```
 
 如果你使用上方“用 agent 工具帮你安装”的提示词，agent 会在添加 MCP server 后引导你运行这两个命令。`config` 输入不会在终端回显，会把 Cookie 保存到本机凭证配置；MCP server 启动后会自动读取，不会写入 MCP 客户端配置或仓库。
@@ -1194,6 +1197,7 @@ BILIBILI_DEDEUSERID=<your_dedeuserid>
 | 想看观众反馈和热门评论 | `get_video_comments` | 热门评论、时间戳评论、可选回复 |
 | 让 agent 引导用户配置 Cookie | `get_credential_setup_instructions` | 安全配置步骤、推荐命令、注意事项 |
 | 检查 Cookie 是否已配置/登录 | `check_bilibili_credentials` | configured、source、logged_in、next_steps |
+| 检查 MCP 包是否需要更新 | `check_mcp_update` | current_version、latest_version、update_available、更新命令 |
 
 ## 💡 工具调用示例
 
@@ -1229,6 +1233,21 @@ BILIBILI_DEDEUSERID=<your_dedeuserid>
 
 返回内容：`configured`、`source`（`env` / `global_config` / `none`）、`logged_in` 和 `next_steps`；不会返回任何 Cookie 值。
 
+### `check_mcp_update`
+
+**适合**：检查当前安装的 MCP 包是否落后于 npm latest，并给出安全更新命令。
+
+请求示例：
+
+```json
+{
+  "name": "check_mcp_update",
+  "arguments": {}
+}
+```
+
+返回内容：`current_version`、`latest_version`、`update_available`、`recommended_mcp_config` 和 `update_commands`；不会自动更新包。
+
 ### `get_video_transcript`
 
 **适合**：需要把视频内容交给 AI 做摘要、笔记、问答或知识整理。
@@ -1357,7 +1376,7 @@ npm run watch
 
 - MCP server 的入口是 `dist/index.js`，CLI 入口是 `dist/cli.js`；修改源码后先运行 `npm run build`。
 - 启动 stdio MCP server 后，`stdout` 必须保留给 MCP 协议数据；调试日志和错误信息应写到 `stderr`，因此本项目使用 `console.error` 输出运行日志。
-- 不要在测试、日志、示例或提交内容中写入真实 Cookie。需要验证凭证时，使用 `npx -y @xzxzzx/bilibili-mcp check` 或本地环境变量。
+- 不要在测试、日志、示例或提交内容中写入真实 Cookie。需要验证凭证时，使用 `npx -y @xzxzzx/bilibili-mcp@latest check` 或本地环境变量。
 
 ---
 
@@ -1383,7 +1402,7 @@ npm run watch
 
 1.  **初版生成**：由 **Claude Code** (搭载 **GLM-4.7** 模型) 快速搭建核心架构与基础逻辑。
 2.  **调试与优化**：在 **Antigravity** 环境下，利用 **Claude** 和 **Gemini** 模型进行深度的 Bug 修复与功能增强，确保了字幕提取与评论分析的稳定性。
-3.  **迭代与扩展**：由 **Codex** 进行架构决策与计划分解，**Claude Code** 接入 **DeepSeek** 模型执行实现；目前覆盖 30+ AI 客户端的 MCP 接入配置、6 个 MCP 工具、124 个单元测试。
+3.  **迭代与扩展**：由 **Codex** 进行架构决策与计划分解，**Claude Code** 执行实现；目前覆盖 30+ AI 客户端的 MCP 接入配置、7 个 MCP 工具、145 个单元测试。
 
 ---