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