哔哩哔哩 MCP 服务器 - 支持搜索、弹幕、用户信息等功能的模型上下文协议服务器
Project description
Bilibili API MCP Server
用于哔哩哔哩 API 的 MCP(模型上下文协议)服务器,支持多种操作。
环境要求
- uv - 一个项目管理工具,可以很方便管理依赖。
使用方法
-
clone 本项目
-
使用 uv 安装依赖
uv sync
- 在任意 mcp client 中配置本 Server
{
"mcpServers": {
"bilibili": {
"command": "uv",
"args": [
"--directory",
"/your-project-path/bilibili-mcp-server",
"run",
"bilibili.py"
]
}
}
}
- 在 client 中使用
支持的操作
支持以下操作:
general_search: 基础搜索功能,使用关键词在哔哩哔哩进行搜索。search_user: 专门用于搜索哔哩哔哩用户的功能,可以按照粉丝数排序。get_precise_results: 精确搜索功能,可以过滤掉不必要的信息,支持多种搜索类型:- 用户搜索 (
user):精确匹配用户名,只返回完全匹配的结果。例如搜索"双雷"只会返回用户名为"双雷"的账号信息,不会返回其他相关用户 - 视频搜索 (
video) - 直播搜索 (
live) - 专栏搜索 (
article) 返回结果包含exact_match字段,标识是否找到精确匹配的结果。
- 用户搜索 (
get_video_danmaku·: 获取视频弹幕信息。
如何为本项目做贡献
- Fork 本项目
- 新建分支,并在新的分支上做改动
- 提交 PR
🎉 更新内容
本项目现在包含了完整的打包和部署解决方案:
📦 打包选项
-
Python包打包(推荐)
python build.py pip install dist/*.whl
-
Docker容器化
docker build -t bilibili-mcp-server . docker-compose up -d
-
自动化安装
python install.py
🚀 快速开始
# 1. 自动安装和配置
python install.py
# 2. 或者手动构建
python build.py
# 3. 运行演示
python example.py
📋 生成的配置文件
mcp_config.json- 开发模式配置 (uv run)mcp_config_pip.json- pip安装模式配置mcp_config_uvx.json- uvx运行配置 (推荐)mcp_config_wheel.json- 直接从wheel包运行docker-compose.yml- Docker部署配置Dockerfile- 容器构建文件
📚 详细文档
查看 PACKAGING.md 获取完整的打包指南和使用说明。
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bilibili_mcp_tools-0.1.1.tar.gz.
File metadata
- Download URL: bilibili_mcp_tools-0.1.1.tar.gz
- Upload date:
- Size: 9.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b49134876adb00f39288bf2ceb6c4e76000ec6c57e68c56b71f4b6638cdea044
|
|
| MD5 |
46b1f9e5658999028d213b5730b67055
|
|
| BLAKE2b-256 |
1221919523e93758fb26344225c18901bf7563260652695432a2e8cf28e46945
|
File details
Details for the file bilibili_mcp_tools-0.1.1-py3-none-any.whl.
File metadata
- Download URL: bilibili_mcp_tools-0.1.1-py3-none-any.whl
- Upload date:
- Size: 11.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8c3c3611ef445ce8cb5cabd69ca3b514734116cd421af11b473f10d01b5e1e66
|
|
| MD5 |
83ae680bd56d641ab7a0179aba1fbf8c
|
|
| BLAKE2b-256 |
3653ddf2296db38129f296b33da5a1df07f0af11b209dfed0f0d618f390bf8ab
|