🚀 Bangumi TV MCP 服务
这是一个提供对 BangumiTV API 访问的 MCP（机器通信协议）服务。借助该服务，您可以与 BangumiTV 的数据进行交互，获取动漫、漫画、音乐、游戏等多方面的信息，为您的相关应用或项目注入丰富的数据支持。
🚀 快速开始
本服务提供了便捷的方式来与 BangumiTV 的数据进行交互，下面为您详细介绍。
✨ 主要特性
条目相关功能
/calendar：可进行每日放送查询，让您及时了解每日的动漫等作品放送情况。/v0/search/subjects：用于搜索主题，助您快速定位所需的动漫、漫画等主题。/v0/subjects：可浏览主题列表，全面了解各类主题信息。/v0/subjects/{subject_id}：获取主题详情，深入了解特定主题的详细内容。/v0/subjects/{subject_id}/persons：获取与主题相关的人员列表，知晓参与该主题创作的人员信息。/v0/subjects/{subject_id}/characters：获取与主题相关的角色列表，认识主题中的各类角色。/v0/subjects/{subject_id}/subjects：获取相关主题列表，发现与当前主题相关的其他主题。
章节相关功能
/v0/episodes：获取剧集列表，掌握某一作品的剧集情况。/v0/episodes/{episode_id}：获取剧集详情，深入了解具体剧集的内容。
角色相关功能
/v0/search/characters：搜索角色，方便查找特定角色。/v0/characters/{character_id}：获取角色详情，了解角色的详细信息。/v0/characters/{character_id}/subjects：获取与角色相关的主题列表，知晓该角色参与的主题作品。/v0/characters/{character_id}/persons：获取与角色相关的人员列表，了解为该角色配音或创作的人员。
人员相关功能
/v0/search/persons：搜索人员，帮助您找到感兴趣的创作人员。/v0/persons/{person_id}：获取人员详情，深入了解人员的相关信息。/v0/persons/{person_id}/subjects：获取与人员相关的主题列表，了解该人员参与创作的主题作品。/v0/persons/{person_id}/characters：获取与人员相关的角色列表，知晓该人员参与创作的角色。
📦 安装指南
# 克隆仓库
git clone https://github.com/Ukenn2112/BangumiMCP.git
cd BangumiMCP
# 创建并激活虚拟环境
uv venv
source .venv/bin/activate # 适用于 Linux/macOS
# 或在 Windows 上使用:
# .venv\Scripts\activate
# 安装依赖项
uv add "mcp[cli]" requests
💻 使用示例
基础用法
若您使用 Claude 客户端，可参考以下配置文件示例：
{
"mcpServers": {
"bangumi-tv": {
"command": "uv",
"args": [
"--directory",
"/Users/Desktop/bangumi-tv", # 请替换为您的实际目录路径
"run",
"main.py"
],
"env": {
"BANGUMI_TOKEN": "your_token_here" # 请替换为您自己的 BangumiTV 访问令牌（可选）以访问 R18 内容
}
}
}
}
📄 许可证
文档中未提及相关许可证信息。
致谢
本项目目前完全由 Google Gemini 生成。