返回 MCP 目录
verified_user已验证dns本地运行

bilibili-mcp-js

一个基于Model Context Protocol (MCP)的B站视频搜索服务器,提供API接口支持视频内容搜索、分页查询及视频信息返回,包含LangChain调用示例和测试脚本。

article

README

🚀 Bilibili MCP 服务器

这是一个基于 Model Context Protocol (MCP) 的 B站视频搜索服务器。它提供了简单的 API 接口,方便用户搜索 B站的视频内容,同时还提供了 LangChain 调用示例和测试脚本。

🚀 快速开始

⚠️ 重要提示

若要运行 LangChain 示例,请先配置 LLM 模型,修改 .example.ts 文件。

const llm = new ChatOpenAI({
  modelName: "gpt-4o-mini",
  temperature: 0,
  openAIApiKey: "your_api_key", // 替换为你的模型密钥
  configuration: {
    baseURL: "https://www.api.com/v1", // 替换为你的 API 地址
  },
});

运行指令

  • bun 环境:

    bun i
    bun index.ts
    # 测试脚本
    bun test.js
    # MCP 检查工具
    bun run inspector
    # 运行 LangChain 示例
    bun build:bun
    bun example.ts
    
  • npm 环境:

    npm i
    npm run start
    # 测试脚本
    npm run test
    # MCP 检查工具
    npm run inspector
    # 运行 LangChain 示例
    npm run build
    node dist/example.js
    

✨ 主要特性

  • B站视频搜索功能
  • 支持分页查询
  • 返回视频信息(标题、作者、播放量、时长等)
  • 基于 MCP 协议的标准化接口设计

📦 安装指南

系统要求:

  • Node.js >= 20.12.0

npm 包: 感谢 HQHC 发布的 npm 包:

{
  "mcpServers": {
    "bilibili-search": {
    "command": "npx",
    "args": ["bilibili-mcp"],
    "description": "B站视频搜索 MCP 服务,支持在 AI 应用中调用 B站视频内容。"
    }
  }
}

💻 使用示例

基础用法

const llm = new ChatOpenAI({
  modelName: "gpt-4o-mini",
  temperature: 0,
  openAIApiKey: "your_api_key", // 替换为你的模型密钥
  configuration: {
    baseURL: "https://www.api.com/v1", // 替换为你的 API 地址
  },
});

📚 详细文档

截图

说明: 图1:测试结果
说明: 图2:其他测试结果

📄 许可证

文档中未提及许可证信息,若有相关内容可补充至此。

鸣谢

参考了 mcp-langchain-ts-client 的 LangChain 示例代码。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端