项目介绍
Bangumi MCP
Bangumi MCP是一个模型上下文协议(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文件。