Readme Md

Bangumi MCP

中文版本

A Model Context Protocol (MCP) server for accessing Bangumi API

Bangumi MCP是一个模型上下文协议（MCP）服务器，提供对 API班吉米，允许用户搜索和检索有关动漫、漫画和其他相关内容的信息。

特性

Bangumi MCP服务器为与Bangumi API交互提供了一套全面的工具，包括：

日历和时间

• get_current_time：获取当前时间
• get_calendar：获取每周广播时间表

主题工具

• search_subjects：使用各种过滤器搜索主题
• get_subjects：按类型和类别浏览主题
• get_subject_info：获取特定主题的详细信息
• get_subject_persons：获取主题的人员信息
• get_subject_characters：获取主题的角色信息
• get_subject_relations：获取相关主题

剧集工具

• get_episodes：获取主题的剧集信息
• get_episode_info：获取特定剧集的详细信息

角色工具

• search_characters：搜索字符
• get_character_info：获取详细的角色信息
• get_character_subjects：获取与角色相关的主题
• get_character_persons：获取与角色相关的人员
• post_character_collection：收集一个角色

个人工具

• search_persons：搜索人员
• get_person_info：获取详细的人员信息
• get_person_subjects：获取与某人相关的主题
• get_person_characters：获取与某人相关的角色
• post_person_collection：收集一个人

用户工具

• get_user_info：获取用户信息
• get_me_info：获取当前用户信息

收藏工具

• get_user_collections：获取用户的主题集合
• get_user_collection_info：获取特定主题的用户收藏信息
• post_my_collection：为当前用户收集主题
• patch_my_collection：更新当前用户的主题集
• get_my_episode_collections：获取当前用户的剧集收藏
• patch_my_episode_collections：更新当前用户的剧集集
• get_my_episode_collection_info：获取特定剧集的当前用户剧集集合信息
• put_my_episode_collection_info：更新当前用户的剧集集
• get_user_character_collections：获取用户的角色集合
• get_user_character_collection_info：获取特定角色的用户角色集合信息
• get_user_person_collections：获取用户的个人收藏
• get_user_person_collection_info：获取特定用户的个人收藏信息

安装

1. 克隆存储库：

   git clone https://github.com/etherwindy/Bangumi-MCP.git
   cd Bangumi-MCP

1. 安装软件包：

建议使用紫外线：

   uv pip install -e .

服务器配置

Bangumi MCP服务器需要Bangumi API令牌才能实现全部功能。如果您使用SSE或流式HTTP，则需要在服务器启动之前配置此令牌：

方法1：使用.env文件（推荐）

创建一个 .env 使用Bangumi API令牌的项目根目录中的文件：

BANGUMI_API_TOKEN=your_api_token_here

方法2：使用环境变量

直接在终端中设置环境变量：

export BANGUMI_API_TOKEN=your_api_token_here

在Windows上，使用：

set BANGUMI_API_TOKEN=your_api_token_here

用法

工作室

直接将json配置导入到您的MCP客户端应用程序，如cherry studio：

{
    "mcpServers": {
        "Bangumi-MCP": {
            "command": "uv",
            "args": [
                "--directory",
                "{your_path_to_the_folder}/Bangmumi-MCP",
                "run",
                "bangumi-mcp"
            ],
            "env": {
                "BANGUMI_API_TOKEN": "your_token_here"
            }
        }
    }
}

上海证券交易所

默认情况下，服务器将在 localhost:18080。您可以使用指定不同的主机和端口 --host 和 --port 论据：

cd Bangumi-MCP
uv run bangumi-mcp --mode=sse --host localhost --port 18080

配置您的MCP客户端应用程序，例如：

{
   "mcpServers": {
      "Bangumi-MCP": {
         "type": "sse",
         "url": "http://localhost:18080/sse"
      }
   }
}

流式HTTP

默认情况下，服务器将在 localhost:18080。您可以使用指定不同的主机和端口 --host 和 --port 论据：

cd Bangumi-MCP
uv run bangumi-mcp --mode=streamable_http --host localhost --port 18080

配置您的MCP客户端应用程序，例如：

{
   "mcpServers": {
      "Bangumi-MCP": {
         "type": "streamableHttp",
         "url": "http://localhost:18080/mcp/"
      }
   }
}

致谢

该项目是在Qwen3 Coder和Claude Sonnet 4的协助下完成的。

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。