使用说明
项目简介
本项目 'Bilibili API MCP Server' 是一个 MCP (Model Context Protocol) 服务器的实现,专注于为大型语言模型 (LLM) 应用提供访问哔哩哔哩 (B站) API 的能力。通过此服务器,LLM 可以方便地调用 B站的搜索功能,获取视频信息等,从而扩展 LLM 在内容检索和信息获取方面的能力。目前,该服务器仅支持视频搜索功能,未来计划扩展更多 B站 API 的操作。
主要功能点
- 视频搜索工具: 提供根据关键词搜索 B站视频的功能,LLM 可以调用此工具获取 B站的视频搜索结果,用于内容分析、信息检索等任务。
- MCP 服务器: 遵循 MCP 协议标准,易于集成到支持 MCP 协议的 LLM 客户端中,为 LLM 提供标准化的外部功能调用方式。
安装步骤
- 克隆仓库: 首先,将仓库 'bilibili-mcp-server' 克隆到本地。
- 安装依赖: 使用 'uv' 包管理工具安装项目依赖。在仓库根目录下运行命令 'uv sync'。 (如果尚未安装 'uv',请先参考 uv 官方文档 进行安装)
服务器配置
要将 'Bilibili API MCP Server' 集成到 MCP 客户端,您需要在客户端的 MCP 服务器配置中添加以下信息。以下是一个 JSON 格式的配置示例,您需要根据您的实际项目路径进行调整:
{ "mcpServers": { "bilibili": { "command": "uv", "args": [ "--directory", "/your-project/path/bilibili-mcp-server", // 替换为您的 bilibili-mcp-server 项目的绝对路径 "run", "bilibili.py" ], "serverName": "bilibili" // 服务器名称,可以自定义,用于在客户端中引用 } } }
配置参数说明:
- '"serverName"': 为该 MCP 服务器指定一个名称,例如 "bilibili"。客户端将使用此名称来引用该服务器。
- '"command"': 运行服务器的命令,这里使用 'uv' 命令。
- '"args"': 传递给 'uv' 命令的参数列表:
- '"--directory"': 指定项目目录,请务必将 '/your-project/path/bilibili-mcp-server' 替换为您本地 'bilibili-mcp-server' 项目的绝对路径。
- '"run"': 'uv run' 命令用于运行 Python 脚本。
- '"bilibili.py"': 指定要运行的 Python 脚本为 'bilibili.py',即 MCP 服务器的入口文件。
基本使用方法
配置完成后,在您的 MCP 客户端中,您可以使用配置的 '"serverName"' (例如 "bilibili") 来调用 'Bilibili API MCP Server' 提供的工具。
目前该服务器提供了一个名为 'general_search' 的工具,用于搜索 B站视频。您可以在客户端中使用类似以下的 JSON-RPC 请求来调用该工具:
{ "jsonrpc": "2.0", "method": "call_tool", "params": { "server_name": "bilibili", // 使用配置的 serverName "tool_name": "general_search", "tool_args": { "keyword": "科技 美食" // 替换为您要搜索的关键词 } }, "id": 1 }
服务器将返回包含 B站视频搜索结果的 JSON-RPC 响应。
请注意: 由于该服务器目前仅实现了视频搜索功能,因此只能使用 'general_search' 工具。未来功能扩展后,请关注项目更新和使用说明。
信息
分类
网页与API