@xzxzzx/bilibili-mcp 1.3.2 → 1.3.4

package/README.md

@@ -4,18 +4,25 @@
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
 [![npm downloads](https://img.shields.io/npm/dm/@xzxzzx/bilibili-mcp.svg)](https://www.npmjs.com/package/@xzxzzx/bilibili-mcp)
 
-用claude code(glm4.7模型)做的总结B站视频的MCP(经过antigravity里的claude,gemini模型修改bug)(提取字幕与评论)
+## ✨ **为你的 AI 助手装上 B 站的眼睛**：一键提取视频字幕与热门评论，助力高效信息总结 🚀
+## ✨ **Equip your AI assistant with "Bilibili Eyes"**: One-click extraction of video subtitles and popular comments for efficient information summarization 🚀
+### 🌐 **[English Documentation](https://github.com/365903728-oss/bilibili-mcp/blob/master/README_EN.md)** (English version here)
 
 > [!TIP]
 > ⚠️ **提示**：使用前请务必配置您的 B 站 Cookie，否则将无法提取视频字幕与评论。详见 [**⚙️ 凭证配置**](#️-凭证配置)(凭证只会保存在本地，不会上传到任何地方)。
+>
+> ⚠️ **Notice**: Please make sure to configure your Bilibili Cookies before use, otherwise video subtitles and comments cannot be extracted. See [**⚙️ Credential Configuration**](#️-credential-configuration) (Cookies are only stored locally and will not be uploaded anywhere).
+
 
-View this document in [English](./README_EN.md).
 
 ---
 
 ## 📑 目录
 
 - [Bilibili MCP Tool](#bilibili-mcp-tool)
+  - [✨ **为你的 AI 助手装上 B 站的眼睛**：一键提取视频字幕与热门评论，助力高效信息总结 🚀](#-为你的-ai-助手装上-b-站的眼睛一键提取视频字幕与热门评论助力高效信息总结-)
+  - [✨ **Equip your AI assistant with "Bilibili Eyes"**: One-click extraction of video subtitles and popular comments for efficient information summarization 🚀](#-equip-your-ai-assistant-with-bilibili-eyes-one-click-extraction-of-video-subtitles-and-popular-comments-for-efficient-information-summarization-)
+    - [🌐 **English Documentation** (English version here)](#-english-documentation-english-version-here)
   - [📑 目录](#-目录)
   - [⚡ 快速预检](#-快速预检)
   - [🌟 功能特性](#-功能特性)
@@ -28,7 +35,8 @@ View this document in [English](./README_EN.md).
       - [方法一：通过 CLI 命令快速安装（推荐）](#方法一通过-cli-命令快速安装推荐)
       - [方法二：通过配置文件手动添加（高级）](#方法二通过配置文件手动添加高级)
     - [Claude Desktop (桌面客户端)](#claude-desktop-桌面客户端)
-      - [方法三：通过 npm 全局安装](#方法三通过-npm-全局安装)
+      - [方法一：通过配置文件手动添加](#方法一通过配置文件手动添加)
+      - [方法二：通过 npm 全局安装](#方法二通过-npm-全局安装)
     - [🏗️ Trae (字节跳动官方 IDE)](#️-trae-字节跳动官方-ide)
     - [🌊 Windsurf (Codeium 官方 IDE)](#-windsurf-codeium-官方-ide)
     - [⚡ Zed](#-zed)
@@ -47,6 +55,8 @@ View this document in [English](./README_EN.md).
   - [🛠️ 开发指南](#️-开发指南)
   - [⚖️ 安全性与免责声明](#️-安全性与免责声明)
     - [许可证](#许可证)
+  - [🛠️ 开发过程](#️-开发过程)
+  - [💬 反馈与建议](#-反馈与建议)
 
 ---
 
@@ -134,6 +144,8 @@ claude mcp add bilibili-mcp --command "npx" --args "-y" --args "@xzxzzx/bilibili
 
 Claude Desktop 支持通过全局配置文件接入 MCP 服务器：
 
+#### 方法一：通过配置文件手动添加
+
 1. 打开 Claude Desktop 配置文件：
    - Windows 路径：`%APPDATA%\Claude\claude_desktop_config.json`
    - macOS 路径：`~/Library/Application Support/Claude/claude_desktop_config.json`
@@ -145,14 +157,19 @@ Claude Desktop 支持通过全局配置文件接入 MCP 服务器：
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp"],
+      "env": {
+        "BILIBILI_SESSDATA": "你的_SESSDATA",
+        "BILIBILI_BILI_JCT": "你的_bili_jct",
+        "BILIBILI_DEDEUSERID": "你的_DedeUserID"
+      }
     }
   }
 }
 ```
 3. 保存文件并从侧边栏重启或重新开启对话。
 
-#### 方法三：通过 npm 全局安装
+#### 方法二：通过 npm 全局安装
 
 安装后可直接使用命令行工具管理配置：
 
@@ -426,4 +443,25 @@ npm run watch
 
 ### 许可证
 
-基于 **GNU General Public License v3.0** 开源。
+基于 **GNU General Public License v3.0** 开源。
+
+---
+
+## 🛠️ 开发过程
+
+本项目是一个典型的 AI 协同开发的结晶，完整经历了从原型到完善的过程：
+
+1.  **初版生成**：由 **Claude Code** (搭载 **GLM-4.7** 模型) 快速搭建核心架构与基础逻辑。
+2.  **调试与优化**：在 **Antigravity** 环境下，利用 **Claude** 和 **Gemini** 模型进行深度的 Bug 修复与功能增强，确保了字幕提取与评论分析的稳定性。
+
+---
+
+## 💬 反馈与建议
+
+如果您在使用过程中遇到任何问题，或者有好的功能建议，欢迎通过以下方式联系：
+
+- **提交 Issue**：[GitHub Issues](https://github.com/365903728-oss/bilibili-mcp/issues) —— **推荐方式**，我会定期查看并回复。
+- **项目讨论**：在 [GitHub Discussions](https://github.com/365903728-oss/bilibili-mcp/discussions)（如果已开启）中交流。
+
+感谢您的支持！
+

package/README_EN.md

@@ -4,7 +4,7 @@
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
 [![npm downloads](https://img.shields.io/npm/dm/@xzxzzx/bilibili-mcp.svg)](https://www.npmjs.com/package/@xzxzzx/bilibili-mcp)
 
-A Bilibili video auxiliary MCP tool built based on mainstream AI development tools like Claude Code, Cursor, Trae, and Google Antigravity. It aims to quickly extract core video information, highlights, and popular comments through Large Language Model capabilities, helping you process audio and video content efficiently.
+## ✨ **Equip your AI assistant with "Bilibili Eyes"**: One-click extraction of video subtitles and popular comments for efficient information summarization 🚀
 
 > [!TIP]
 > ⚠️ **Quick Start**: Please make sure to configure your Bilibili Cookies before use, otherwise video subtitles and comments cannot be extracted. See [**⚙️ Credential Configuration**](#⚙️-credential-configuration)(Cookies are only stored locally and will not be uploaded anywhere).
@@ -28,7 +28,8 @@ View this document in [简体中文](./README.md).
       - [Method 1: Fast Installation via CLI (Recommended)](#method-1-fast-installation-via-cli-recommended)
       - [Method 2: Manual Addition via Config File](#method-2-manual-addition-via-config-file)
     - [Claude Desktop](#claude-desktop)
-      - [Method 3: Global npm Installation](#method-3-global-npm-installation)
+      - [Method 1: Manual Addition via Config File](#method-1-manual-addition-via-config-file)
+      - [Method 2: Global npm Installation](#method-2-global-npm-installation)
     - [🏗️ Trae (Official IDE by ByteDance)](#️-trae-official-ide-by-bytedance)
     - [🌊 Windsurf (Official IDE by Codeium)](#-windsurf-official-ide-by-codeium)
     - [⚡ Zed](#-zed)
@@ -134,6 +135,8 @@ Restart Claude Code after completion.
 
 Claude Desktop supports MCP servers via a global configuration file:
 
+#### Method 1: Manual Addition via Config File
+
 1. Open the Claude Desktop configuration file:
    - Windows Path: `%APPDATA%\Claude\claude_desktop_config.json`
    - macOS Path: `~/Library/Application Support/Claude/claude_desktop_config.json`
@@ -145,14 +148,19 @@ Claude Desktop supports MCP servers via a global configuration file:
   "mcpServers": {
     "bilibili-mcp": {
       "command": "npx",
-      "args": ["-y", "@xzxzzx/bilibili-mcp"]
+      "args": ["-y", "@xzxzzx/bilibili-mcp"],
+      "env": {
+        "BILIBILI_SESSDATA": "YOUR_SESSDATA",
+        "BILIBILI_BILI_JCT": "YOUR_bili_jct",
+        "BILIBILI_DEDEUSERID": "YOUR_DedeUserID"
+      }
     }
   }
 }
 ```
 3. Save the file and restart Claude Desktop or start a new conversation to load the tools.
 
-#### Method 3: Global npm Installation
+#### Method 2: Global npm Installation
 
 Manage configuration via the CLI tool after installation:
 
@@ -399,9 +407,29 @@ npm run watch
 ## ⚖️ Safety and Disclaimer
 
 - **Trademark**: Bilibili is a registered trademark of Bilibili Inc. This is a third-party open-source tool.
-- **Spirit**: For personal learning and research only. Commercial exploitation or large-scale scraping is prohibited.
 - **Liability**: Requests originate locally. Developers are not responsible for account restrictions.
 - **Privacy**: No back-end uploading; credentials stored locally.
 
 ### License
-Open-sourced under **GNU General Public License v3.0**.
+Open-sourced under **GNU General Public License v3.0**.
+
+---
+
+## 🛠️ Development Process
+
+This project is a crystal of AI-collaborative development, spanning from prototype to refinement:
+
+1.  **Initial Generation**: Core architecture and base logic were rapidly built by **Claude Code** (powered by **GLM-4.7** model).
+2.  **Debugging & Optimization**: Bugs were fixed and features enhanced using **Claude** and **Gemini** models within the **Antigravity** environment, ensuring stable subtitle extraction and comment analysis.
+3.  **Multi-IDE Compatibility**: Through iterative updates, it now seamlessly supports Cursor, Trae, Windsurf, Zed, and mainstream AI CLI tools.
+
+---
+
+## 💬 Feedback & Suggestions
+
+If you encounter any issues or have feature suggestions, feel free to reach out:
+
+- **Submit an Issue**: [GitHub Issues](https://github.com/365903728-oss/bilibili-mcp/issues) — **Recommended**, I check and respond regularly.
+- **Discussions**: Join our [GitHub Discussions](https://github.com/365903728-oss/bilibili-mcp/discussions) (if enabled) for general chat.
+
+Thank you for your support!

package/dist/index.d.ts

@@ -1,2 +1,3 @@
-export {};
+import { server } from "./server.js";
+export default server;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiBrC,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -1,24 +1,34 @@
 // MCP 服务器入口
-import { config } from 'dotenv';
-import { fileURLToPath } from 'url';
-import { dirname, resolve } from 'path';
+import { config } from "dotenv";
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+import { server } from "./server.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 // 获取当前文件的目录
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-// 使用绝对路径加载.env文件
-const envPath = resolve(__dirname, '../.env');
-config({ path: envPath });
-import { server } from "./server.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-// 启动服务器
+// 尝试加载.env文件
+const envPath = resolve(__dirname, "../.env");
+try {
+    config({ path: envPath });
+}
+catch (e) {
+    // .env is optional
+}
+// 供 Smithery 沙盒反射使用的纯净实例导出
+// 绝不能在这里执行任何副作用
+export default server;
+// 启动服务器的入口点
 async function main() {
-    console.error("本工具仅供技术研究使用，请确保您的访问行为符合平台规范");
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error("Bilibili MCP server running on stdio");
 }
-main().catch((error) => {
-    console.error("Fatal error in main():", error);
-    process.exit(1);
-});
+// 检查是否作为主模块运行
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+    main().catch((error) => {
+        console.error("Fatal error:", error);
+        process.exit(1);
+    });
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAExC,YAAY;AACZ,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,iBAAiB;AACjB,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAC9C,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAE1B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,QAAQ;AACR,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;AACxD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,YAAY;AACZ,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,aAAa;AACb,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAC9C,IAAI,CAAC;IACH,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAC5B,CAAC;AAAC,OAAO,CAAC,EAAE,CAAC;IACX,mBAAmB;AACrB,CAAC;AAED,2BAA2B;AAC3B,gBAAgB;AAChB,eAAe,MAAM,CAAC;AAEtB,YAAY;AACZ,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;AACxD,CAAC;AAED,cAAc;AACd,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/smithery-test.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+declare const server: McpServer;
+export default server;
+//# sourceMappingURL=smithery-test.d.ts.map

package/dist/smithery-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smithery-test.d.ts","sourceRoot":"","sources":["../src/smithery-test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,QAAA,MAAM,MAAM,WAGV,CAAC;AAUH,eAAe,MAAM,CAAC"}

package/dist/smithery-test.js

@@ -0,0 +1,11 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+const server = new McpServer({
+    name: "test",
+    version: "1"
+});
+server.tool("dummy_tool", { input: z.string() }, async ({ input }) => ({
+    content: [{ type: "text", text: `Dummy ${input}` }]
+}));
+export default server;
+//# sourceMappingURL=smithery-test.js.map

package/dist/smithery-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smithery-test.js","sourceRoot":"","sources":["../src/smithery-test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,GAAG;CACb,CAAC,CAAC;AAEH,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EACrB,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,KAAK,EAAE,EAAE,CAAC;CACpD,CAAC,CACH,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@xzxzzx/bilibili-mcp",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "description": "Bilibili MCP tool for video and comment summarization",
   "type": "module",
-  "main": "dist/index.js",
+  "main": "src/index.ts",
+  "module": "./src/index.ts",
   "bin": {
     "bilibili-mcp": "dist/cli.js"
   },
@@ -11,6 +12,8 @@
     "build": "tsc",
     "watch": "tsc --watch",
     "start": "node dist/index.js",
+    "dev": "smithery dev",
+    "build:smithery": "smithery build",
     "prepublishOnly": "npm run build",
     "test": "echo \"Error: no test specified\" && exit 1",
     "test:env": "node -e \"console.log('检查环境变量...'); console.log('BILIBILI_SESSDATA:', process.env.BILIBILI_SESSDATA ? '✅ 已配置' : '❌ 未配置'); console.log('BILIBILI_BILI_JCT:', process.env.BILIBILI_BILI_JCT ? '✅ 已配置' : '❌ 未配置'); console.log('BILIBILI_DEDEUSERID:', process.env.BILIBILI_DEDEUSERID ? '✅ 已配置' : '❌ 未配置');\"",
@@ -58,7 +61,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "commander": "^14.0.3",
     "dotenv": "^17.2.4",
     "quick-lru": "^7.3.0"
@@ -68,7 +71,9 @@
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^11.0.1",
     "@semantic-release/npm": "^12.0.1",
+    "@smithery/cli": "^4.5.0",
     "@types/node": "^22.19.8",
+    "esbuild": "^0.24.2",
     "semantic-release": "^25.0.3",
     "typescript": "^5.7.2"
   }

package/src/index.ts

@@ -0,0 +1,37 @@
+// MCP 服务器入口
+import { config } from "dotenv";
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+import { server } from "./server.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// 获取当前文件的目录
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// 尝试加载.env文件
+const envPath = resolve(__dirname, "../.env");
+try {
+  config({ path: envPath });
+} catch (e) {
+  // .env is optional
+}
+
+// 供 Smithery 沙盒反射使用的纯净实例导出
+// 绝不能在这里执行任何副作用
+export default server;
+
+// 启动服务器的入口点
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Bilibili MCP server running on stdio");
+}
+
+// 检查是否作为主模块运行
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+  main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+  });
+}