article

README

🚀 Bangumi TV MCP 服务

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

🚀 快速开始

本服务可让您轻松访问 BangumiTV API，与平台数据进行交互。以下是使用前的准备步骤和使用示例。

✨ 主要特性

本服务提供了丰富的 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_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 内容
            }
        }
    }
}

高级用法

更多使用说明可参考此 URL：https://mcpcn.com/docs/quickstart/user/

📚 详细文档

示例输出如下： output

致谢

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

Bangumi TV