acuvity/mcp-server-bilibili-js

mcp-server-bilibili-js 镜像文档

镜像概述

mcp-server-bilibili-js是一个用于搜索B站内容的MCP（Model Context Protocol）服务器Docker镜像。该镜像由Acuvity基于https://github.com/34892002/bilibili-mcp-js原始代码打包，并发布到Acuvity的MCP服务器https://mcp.acuvity.ai。其核心功能是为AI代理系统提供安全、可靠的B站内容搜索能力。

核心功能与特性

安全特性

隔离的不可变沙箱

运行时安全与防护措施

Minibridge集成：https://github.com/acuvity/minibridge建立安全的Agent-to-MCP连接，支持Rego/HTTP-based策略执行，并简化编排。容器内置Rego策略，提供以下运行时防护措施：

注意：默认情况下，除resource integrity外所有防护措施均关闭。可单独启用或禁用每个措施，确保只激活环境所需的保护。

使用场景与适用范围

• 集成到AI代理系统，为其提供B站内容搜索能力
• 开发环境中与IDE（如VS Code、Windsurf、Cursor、Claude Desktop）集成，增强Copilot体验
• 企业环境中通过Kubernetes集群部署，实现安全可控的B站内容访问

使用方法与配置说明

快速参考

• 维护者：
  • Acuvity团队（打包维护，***）
  • https://github.com/34892002/bilibili-mcp-js（原始应用）
• 支持架构：amd64、arm64
• 基础镜像：node:23.11.0-alpine3.21
• 最新标签：latest -> 1.0.0-0.1.2 -> 0.1.2（https://hub.docker.com/r/acuvity/mcp-server-bilibili-js/tags）
• **使用https://github.com/sigstore/cosign验证签名**：

  console
  cosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-bilibili-js:latest
  cosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-bilibili-js:0.1.2
  cosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-bilibili-js:1.0.0-0.1.2
  

IDE集成

Visual Studio Code

一键安装：

全局配置： 按ctrl + shift + p，输入Preferences: Open User Settings JSON，添加以下配置：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-bilibili-js": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "docker.io/acuvity/mcp-server-bilibili-js:0.1.2"
        ]
      }
    }
  }
}

工作区配置： 在工作区创建.vscode/mcp.json文件：

json
{
  "servers": {
    "acuvity-mcp-server-bilibili-js": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "docker.io/acuvity/mcp-server-bilibili-js:0.1.2"
      ]
    }
  }
}

Windsurf IDE

在~/.codeium/windsurf/mcp_config.json中添加：

json
{
  "mcpServers": {
    "acuvity-mcp-server-bilibili-js": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "docker.io/acuvity/mcp-server-bilibili-js:0.1.2"
      ]
    }
  }
}

Cursor IDE

在全局配置文件~/.cursor/mcp.json或项目配置文件.cursor/mcp.json中添加：

json
{
  "mcpServers": {
    "acuvity-mcp-server-bilibili-js": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "docker.io/acuvity/mcp-server-bilibili-js:0.1.2"
      ]
    }
  }
}

Claude Desktop

在claude_desktop_config.json中添加：

json
{
  "mcpServers": {
    "acuvity-mcp-server-bilibili-js": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "docker.io/acuvity/mcp-server-bilibili-js:0.1.2"
      ]
    }
  }
}

OpenAI Python SDK

本地运行：

python
async with MCPServerStdio(
    params={
        "command": "docker",
        "args": ["run","-i","--rm","--read-only","docker.io/acuvity/mcp-server-bilibili-js:0.1.2"]
    }
) as server:
    tools = await server.list_tools()

远程运行：

python
async with MCPServerSse(
    params={
        "url": "http://<ip>:<port>/sse",
    }
) as server:
    tools = await server.list_tools()

Docker部署

本地STDIO模式

在客户端配置中设置：

• 命令：docker
• 参数：run -i --rm --read-only docker.io/acuvity/mcp-server-bilibili-js:0.1.2

本地HTTP/sse模式

运行容器：

console
docker run -it -p 8000:8000 --rm --read-only docker.xuanyuan.run/acuvity/mcp-server-bilibili-js:0.1.2

客户端配置示例：

json
{
  "mcpServers": {
    "acuvity-mcp-server-bilibili-js": {
      "url": "http://localhost:8000/sse"
    }
  }
}

远程Websocket隧道与MTLS模式

1. 启动后端模式服务器：

console
docker run -it -p 8000:8000 --rm --read-only \
  -e MINIBRIDGE_MODE=backend \
  -v $PWD/certs:/certs \
  -e MINIBRIDGE_TLS_SERVER_CERT=/certs/server-cert.pem \
  -e MINIBRIDGE_TLS_SERVER_KEY=/certs/server-key.pem \
  -e MINIBRIDGE_TLS_SERVER_CLIENT_CA=/certs/client-ca.pem \
  docker.xuanyuan.run/acuvity/mcp-server-bilibili-js:0.1.2

2. 本地启动Minibridge前端（需先安装https://github.com/acuvity/minibridge）：

json
{
  "mcpServers": {
    "acuvity-mcp-server-bilibili-js": {
      "command": "minibridge",
      "args": ["frontend", "--backend", "wss://<remote-url>:8000/ws", "--tls-client-backend-ca", "/path/to/ca.pem", "--tls-client-cert", "/path/to/client-cert.pem", "--tls-client-key", "/path/to/client-key.pem"]
    }
  }
}

Kubernetes部署（Helm Charts）

安装Helm Chart

查看Chart信息：

console
helm show readme oci://docker.io/acuvity/mcp-server-bilibili-js --version 1.0.0
helm show values oci://docker.io/acuvity/mcp-server-bilibili-js --version 1.0.0

安装Chart：

console
helm install mcp-server-bilibili-js oci://docker.io/acuvity/mcp-server-bilibili-js --version 1.0.0

默认情况下，MCP服务器可通过Kubernetes服务mcp-server-bilibili-js在集群内通过http/sse访问，端口为8000。可通过修改values.yaml中的service部分调整配置。

监控

部署会创建带有healthPort的Kubernetes服务，用于存活探针和就绪探针。健康端口还可用于监控，在/metrics路径下暴露指标。

服务器特性

有关该服务器提供的所有功能、工具、参数和SBOM哈希的详细列表，请参阅https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-bilibili-js。

工具（1）

提供B站内容搜索工具，具体功能和参数请参考原始项目文档。

问题咨询：提交issue或联系***
欢迎贡献！