Bangumi 工具
# 一个可以访问 Bangumi API 的模型上下文协议（MCP）服务器 ## 概述 本项目旨在创建一个遵循模型上下文协议（Model Context Protocol, MCP）的服务器，该服务器能够与Bangumi API进行交互。通过此服务器，用户可以请求关于动画、漫画及游戏的相关信息。 ## 安装 要运行此MCP服务器，请确保你的环境中已安装了`requests`库。你可以使用pip来安装它： bash pip install requests ## 配置 在启动服务器之前，你需要配置一些基本参数。请编辑`config.json`文件，设置你的API密钥和其他必要的选项。 json { "api_key": "your_bangumi_api_key", "server_port": 8080, "log_level": "info" } ## 启动服务器 完成配置后，可以通过以下命令启动服务器： bash python mcp_server.py 默认情况下，服务器将在端口8080上监听请求。如果需要更改端口号，请修改`config.json`中的`server_port`字段。 ## 使用说明 一旦服务器开始运行，你就可以发送符合MCP规范的消息来获取数据了。例如，下面是一个查询特定动漫详细信息的请求示例： json { "action": "query", "resource": "anime", "id": 12345 } 将上述JSON对象作为POST请求的数据体发送到`http://localhost:8080/api`即可获得响应。 更多关于支持的动作(action)和资源(resource)类型的信息，请参考[官方文档](https://example.com/docs)。 ## 贡献 我们欢迎任何形式的贡献！如果你发现了bug或有改进的想法，请随时提交issue或pull request。 ## 许可证 本项目采用MIT许可证发布。详情见[LICENSE](LICENSE)文件。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"Bangumi-MCP": {
"args": [
"httpx==0.28.1",
"mcp==1.12.2",
"python-dotenv==1.1.1",
"starlette==0.47.2",
"uvicorn==0.35.0"
],
"command": "",
"env": {
"BANGUMI_API_TOKEN": "BANGUMI_API_TOKEN"
}
}
}
}服务介绍
Bangumi MCP
Bangumi MCP 是一个 Model Context Protocol (MCP) 服务器，提供对 Bangumi API 的访问，允许用户搜索和检索有关动漫、漫画和其他相关内容的信息。
功能
Bangumi MCP 服务器提供了与 Bangumi API 交互的一整套工具，包括：
日历和时间
get_current_time: 获取当前时间get_calendar: 获取每周播放时间表
主题工具
search_subjects: 使用各种过滤器搜索主题get_subjects: 按类型和类别浏览主题get_subject_info: 获取特定主题的详细信息get_subject_persons: 获取主题的人物信息get_subject_characters: 获取主题的角色信息get_subject_relations: 获取相关主题
剧集工具
get_episodes: 获取主题的剧集信息get_episode_info: 获取特定剧集的详细信息
角色工具
search_characters: 搜索角色get_character_info: 获取详细的角色信息get_character_subjects: 获取与角色相关的主题get_character_persons: 获取与角色相关的人物post_character_collection: 收藏角色
人物工具
search_persons: 搜索人物get_person_info: 获取详细的人物信息get_person_subjects: 获取与人物相关的主题get_person_characters: 获取与人物相关的角色post_person_collection: 收藏人物
用户工具
get_user_info: 获取用户信息get_me_info: 获取当前用户信息
收藏工具
get_user_collections: 获取用户的主题收藏get_user_collection_info: 获取用户特定主题的收藏信息post_my_collection: 为当前用户收藏一个主题patch_my_collection: 更新当前用户的主题收藏get_my_episode_collections: 获取当前用户的剧集收藏patch_my_episode_collections: 更新当前用户的剧集收藏get_my_episode_collection_info: 获取当前用户特定剧集的收藏信息put_my_episode_collection_info: 更新当前用户的剧集收藏get_user_character_collections: 获取用户的角色收藏get_user_character_collection_info: 获取用户特定角色的收藏信息get_user_person_collections: 获取用户的人物收藏get_user_person_collection_info: 获取用户特定人物的收藏信息
安装
-
克隆仓库：
git clone https://github.com/etherwindy/Bangumi-MCP.git cd Bangumi-MCP -
安装包：
推荐使用 uv：
uv pip install -e .
服务器配置
Bangumi MCP 服务器需要一个 Bangumi API 令牌才能完全运行。如果你使用 SSE 或可流式传输的 HTTP，则需要在服务器启动前配置此令牌：
方法 1：使用 .env 文件（推荐）
在项目根目录中创建一个 .env 文件，并添加你的 Bangumi API 令牌：
BANGUMI_API_TOKEN=your_api_token_here
方法 2：使用环境变量
直接在终端中设置环境变量：
export BANGUMI_API_TOKEN=your_api_token_here
在 Windows 上，使用：
set BANGUMI_API_TOKEN=your_api_token_here
使用
STDIO
直接将 JSON 配置导入到你的 MCP 客户端应用程序中，例如 cherry-studio：
{
"mcpServers": {
"Bangumi-MCP": {
"command": "uv",
"args": [
"--directory",
"{your_path_to_the_folder}/Bangmumi-MCP",
"run",
"bangumi-mcp"
],
"env": {
"BANGUMI_TOKEN": "your_token_here"
}
}
}
}
SSE默认情况下，服务器将在 localhost:18080 上运行。您可以使用 --host 和 --port 参数指定不同的主机和端口：
cd Bangumi-MCP
uv run bangumi-mcp --mode=sse --host localhost --port 18080
配置您的MCP客户端应用程序，例如：
{
"mcpServers": {
"Bangumi-MCP": {
"type": "sse",
"url": "http://localhost:18080/sse"
}
}
}
可流式传输的HTTP
默认情况下，服务器将在 localhost:18080 上运行。您可以使用 --host 和 --port 参数指定不同的主机和端口：
cd Bangumi-MCP
uv run bangumi-mcp --mode=streamable_http --host localhost --port 18080
配置您的MCP客户端应用程序，例如：
{
"mcpServers": {
"Bangumi-MCP": {
"type": "streamableHttp",
"url": "http://localhost:18080/mcp/"
}
}
}
致谢
本项目在Qwen3-Coder和Claude Sonnet 4的帮助下构建。
许可证
本项目根据MIT许可证发布。详情请参阅 LICENSE 文件。
