金大哥 - BangumiMCP MCP 详情

article

README

🚀 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 生成。

示例输出

output

BangumiMCP