NullBR MCP Server(nullbr已关站)

简介

NullBR API的题目搜索API现已兼容MCP协议，可以让任意支持MCP协议的智能体助手（如`Claude`、`Cursor`、`Cherry Studio`等）快速接入NullBR API，搜索和获取影视资源信息，并可以转存入CMS中。

本项目依赖 `MCP Java SDK` 开发，基于 Spring AI 框架实现。

采用 SSE (服务器发送事件) 协议，支持流式响应。

工具列表

本项目提供了丰富的影视资源查询与管理工具：

搜索与详情

• 影视搜索 (`searchMedia`): 搜索电影、电视剧、人物或合集。
• 获取列表 (`getList`): 获取特定列表详情。
• 获取电影详情 (`getMovieInfo`): 获取电影详细元数据。
• 获取电视剧详情 (`getTVInfo`): 获取电视剧详细元数据。
• 获取电视剧季详情 (`getTVSeasonInfo`): 获取特定季度的详情。
• 获取电视剧集详情 (`getTVEpisodeInfo`): 获取特定集数的详情。
• 获取人物信息 (`getPersonInfo`): 获取演职人员详情。
• 获取电影合集信息 (`getCollectionInfo`): 获取系列电影合集详情。

资源获取

• 获取电影资源 (`getMovieResources`): 获取电影的下载/播放资源。
• 获取电视剧资源 (`getTVResources`): 获取电视剧网盘资源。
• 获取电视剧季资源 (`getTVSeasonResources`): 获取特定季度的资源。
• 获取电视剧集资源 (`getTVEpisodeResources`): 获取特定集数的资源。
• 获取人物资源 (`getPersonResources`): 获取人物相关的网盘资源。
• 获取合集资源 (`getCollectionResources`): 获取电影合集的网盘资源。

CMS 管理

• 添加115分享链接 (`addShareDown`): 将获取的115分享链接添加到CMS系统进行转存。

快速开始

1. 环境要求

• JDK 17+
• Maven 3.6+

2. 安装与配置

git clone https://github.com/yourusername/mcp-nullbr-server
cd mcp-nullbr-server

在运行之前，您需要配置 `src/main/resources/application.yml` 文件，填入您的 API 密钥和 CMS 配置：

nullbr:
  api:
    base-url: https://api.nullbr.eu.org
    app-id: 您的APP_ID
    api-key: 您的API_KEY

cms:
  base-url: 您的CMS地址
  username: 您的CMS账号
  password: 您的CMS密码

3. 构建

mvn clean package

4. 运行

使用以下命令启动 SSE 服务（默认端口 8080）：

java -jar target/mcp-nullbr-server-0.0.1-SNAPSHOT.jar

5. 接入客户端

通过 Cherry Studio 接入

1. 打开 Cherry Studio 设置，点击 "MCP 服务器"。

2. 点击 "添加"，配置如下：

3. 保存配置。

4. 在设置 -> 模型服务中，确保已启用 "工具函数调用" (Function Calling)。

5. 在对话界面开启 MCP 服务。

6. 现在您可以直接向 AI 询问，例如：

许可证

MIT