项目简介

BangumiMCP 是一个基于 Model Context Protocol (MCP) 的服务器，它允许您通过 LLM 客户端访问 Bangumi TV 的数据。您可以查询动漫、漫画、音乐、游戏等条目的信息，并进行浏览和搜索。

主要功能点

每日放送查询: 获取 Bangumi TV 当日及未来一周的动漫放送时间表。
条目搜索: 通过关键词搜索 Bangumi TV 上的动漫、漫画、音乐、游戏等条目。
条目浏览: 根据类型和分类浏览 Bangumi TV 的条目列表。
详细信息: 获取条目、章节、角色、人物的详细信息，包括简介、评分、关联人物/角色/条目等。

安装步骤

克隆仓库

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

服务器配置

MCP 服务器配置信息（例如 'claude_desktop_config.json'）:

{
    "mcpServers": {
        "bangumi-tv": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/BangumiMCP",  // 将 "/path/to/BangumiMCP" 替换为 BangumiMCP 仓库在您电脑上的实际路径
                "run",
                "main.py"
            ],
            // "env": {  // 可选：如果您需要访问 BangumiTV 的 R18 内容，请配置 BANGUMI_TOKEN 环境变量
            //     "BANGUMI_TOKEN": "your_token_here"  // 将 "your_token_here" 替换为您的 BangumiTV 令牌
            // }
        }
    }
}

配置说明:

'"server name": "bangumi-tv"': 为该 MCP 服务器配置一个名称，例如 "bangumi-tv"。
'"command": "uv"': 指定用于启动服务器的命令，这里使用 'uv' 运行 Python 脚本。
'"args": [...]': 启动命令的参数列表：
- '"--directory", "/path/to/BangumiMCP"': 指定 BangumiMCP 仓库的目录。请务必替换为实际路径。
- '"run", "main.py"': 运行仓库目录下的 'main.py' 文件，即 MCP 服务器的入口文件。
'"env": {...}' (可选): 配置环境变量，例如 'BANGUMI_TOKEN' 用于 BangumiTV API 的身份验证，如果需要访问 R18 内容，请配置此项。

基本使用方法

确保已按照 服务器配置 中的说明，在 MCP 客户端（如 Claude）中正确配置 BangumiMCP 服务器。
启动 MCP 客户端，客户端会自动连接到 BangumiMCP 服务器。
通过自然语言指令与 LLM 客户端交互，即可使用 BangumiMCP 提供的功能。例如：
- 询问 "今天有什么动漫放送？" （对应 'get_daily_broadcast' 工具）
- 询问 "搜索关于 ‘咒术回战’ 的动漫" （对应 'search_subjects' 工具）
- 询问 "我想看评分高的动画" （可以结合 'browse_subjects' 工具，并指定 'subject_type=2' 和 'sort='rank''）
- 询问 "查询 ‘进击的巨人’ 的详细信息" （对应 'get_subject_details' 工具）

LLM 将根据您的指令，自动调用 BangumiMCP 服务器提供的工具，并返回 Bangumi TV 的相关数据。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息