@xzxzzx/bilibili-mcp 1.6.0 → 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.6.0](https://github.com/XZXZZX-Ai/bilibili-mcp/releases/tag/v1.6.0)
+🌐 [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。详见 [**凭证配置**](#️-凭证配置)。
@@ -186,6 +186,8 @@ npx -y @xzxzzx/bilibili-mcp@latest check
 > 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
@@ -1231,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 做摘要、笔记、问答或知识整理。

package/README_EN.md

@@ -6,7 +6,7 @@
 
 MCP server that gives AI clients access to Bilibili video subtitles, transcripts, metadata, and popular comments.
 
-View in [简体中文](https://github.com/XZXZZX-Ai/bilibili-mcp/blob/master/README.md) · 📜 [Changelog](https://github.com/XZXZZX-Ai/bilibili-mcp/blob/master/CHANGELOG_EN.md) · 📦 [npm](https://www.npmjs.com/package/@xzxzzx/bilibili-mcp) · 🚀 [Release v1.6.0](https://github.com/XZXZZX-Ai/bilibili-mcp/releases/tag/v1.6.0)
+View in [简体中文](https://github.com/XZXZZX-Ai/bilibili-mcp/blob/master/README.md) · 📜 [Changelog](https://github.com/XZXZZX-Ai/bilibili-mcp/blob/master/CHANGELOG_EN.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]
 > ⚠️ You can copy the "Install With Your Agent" prompt below to Codex, Claude Code, Cursor, or another agent and let it add this MCP server to your client and guide Cookie setup. For reliable subtitles, transcripts, and comments, you still need to configure Bilibili Cookies after installation; do not write Cookies into MCP client config. Metadata may work without cookies. See [**Credential Configuration**](#-credential-configuration).
@@ -177,7 +177,7 @@ After the MCP server is connected, if available, call get_credential_setup_instr
 > Do not write real Cookie values in MCP client config files. Prefer `bilibili-mcp config` to save credentials to the local credential config, or provide environment variables in the runtime environment; the MCP server will read those credentials automatically when it starts. See [⚙️ Credential Configuration](#-credential-configuration).
 
 > [!IMPORTANT]
-> If you are an AI agent installing this MCP for a user: do not stop after writing the MCP client config. After adding the `bilibili-mcp` server, you must remind and guide the user to configure Bilibili Cookies separately. After connecting the MCP server, agents can also call `get_credential_setup_instructions` or `check_bilibili_credentials` to guide the user.
+> If you are an AI agent installing this MCP for a user: do not stop after writing the MCP client config. After adding the `bilibili-mcp` server, you must remind and guide the user to configure Bilibili Cookies separately. After connecting the MCP server, agents can also call `get_credential_setup_instructions`, `check_bilibili_credentials`, or `check_mcp_update` to guide the user.
 >
 > Recommended commands:
 >
@@ -1197,6 +1197,7 @@ Do not share cookies with others. Do not paste them into public chats, issues, P
 | View audience reactions | `get_video_comments` | Popular comments, timestamped highlights, optional replies |
 | Guide users through Cookie setup | `get_credential_setup_instructions` | Safe setup steps, recommended commands, security notes |
 | Check whether Cookies are configured/logged in | `check_bilibili_credentials` | configured, source, logged_in, next_steps |
+| Check whether the MCP package needs an update | `check_mcp_update` | current_version, latest_version, update_available, update commands |
 
 ## 💡 Tool Call Examples
 
@@ -1232,6 +1233,21 @@ Request:
 
 Returns: `configured`, `source` (`env` / `global_config` / `none`), `logged_in`, and `next_steps`; never returns Cookie values.
 
+### `check_mcp_update`
+
+**Best for**: checking whether the installed MCP package is behind npm latest and showing safe update commands.
+
+Request:
+
+```json
+{
+  "name": "check_mcp_update",
+  "arguments": {}
+}
+```
+
+Returns: `current_version`, `latest_version`, `update_available`, `recommended_mcp_config`, and `update_commands`; never updates packages automatically.
+
 ### `get_video_transcript`
 
 **Best for**: feeding video content into AI for summarization, note-taking, Q&A, or knowledge management.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xzxzzx/bilibili-mcp",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Bilibili MCP tool for video metadata, transcripts, subtitles, and comment summarization",
   "type": "module",
   "main": "dist/index.js",