🚀 Bangumi TV MCP 服务

这是一个 MCP（机器通信协议）服务，可提供对 BangumiTV API 的访问权限。借助该服务，您能够与 BangumiTV 的数据进行交互，检索有关动漫、漫画、音乐、游戏等方面的信息。

🚀 快速开始

此 MCP 服务允许您与 BangumiTV 的数据进行交互，以下是相关介绍。

示例输出

✨ 主要特性

本服务提供了丰富的 API 接口，涵盖条目、章节、角色和人员等多个方面，具体如下：

条目

• /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客户端为例： URL: https://mcpcn.com/docs/quickstart/user/

claude_desktop_config.json 配置文件示例：

{
    "mcpServers": {
        "bangumi-tv": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/Desktop/bangumi-tv", # 替换为你的实际路径
                "run",
                "main.py"
            ],
            "env": {
                "BANGUMI_TOKEN": "your_token_here" # 替换为你的 BangumiTV 令牌 （可选）如果你需要查看或搜索 R18 内容
            }
        }
    }
}

📄 致谢

此项目目前完全由 Google Gemini 生成。