NullBR MCP Server

Un servidor para buscar y recuperar información de películas y recursos multimedia a través del protocolo MCP.

GitHub
23
Prueba este MCPPatrocinado

Documentación

NullBR MCP Server(nullbr已关站)

Introducción

La API de búsqueda de preguntas de NullBR API ahora es compatible con el protocolo MCP, lo que permite que cualquier agente inteligente compatible con MCP (como Claude, Cursor, Cherry Studio, etc.) se conecte rápidamente a NullBR API, busque y obtenga información de recursos de video, y pueda transferirlos a un CMS.

Este proyecto depende de MCP Java SDK para su desarrollo y está implementado sobre el framework Spring AI. Utiliza el protocolo SSE (Server-Sent Events), compatible con respuestas en streaming.

Lista de herramientas

Este proyecto ofrece un amplio conjunto de herramientas de consulta y gestión de recursos de video:

Búsqueda y detalles

  • Búsqueda de video (searchMedia): Busca películas, series de televisión, personas o colecciones.
    • Entrada: query (palabra clave), page (número de página, opcional)
  • Obtener lista (getList): Obtiene los detalles de una lista específica.
    • Entrada: listId, page
  • Obtener detalles de película (getMovieInfo): Obtiene metadatos detallados de una película.
    • Entrada: tmdbId
  • Obtener detalles de serie de televisión (getTVInfo): Obtiene metadatos detallados de una serie de televisión.
    • Entrada: tmdbId
  • Obtener detalles de temporada de serie (getTVSeasonInfo): Obtiene los detalles de una temporada específica.
    • Entrada: tmdbId, seasonNumber
  • Obtener detalles de episodio de serie (getTVEpisodeInfo): Obtiene los detalles de un episodio específico.
    • Entrada: tmdbId, seasonNumber, episodeNumber
  • Obtener información de persona (getPersonInfo): Obtiene detalles de actores y equipo técnico.
    • Entrada: tmdbId, page
  • Obtener información de colección de películas (getCollectionInfo): Obtiene detalles de colecciones de películas en serie.
    • Entrada: tmdbId

Obtención de recursos

  • Obtener recursos de película (getMovieResources): Obtiene recursos de descarga/reproducción de una película.
    • Entrada: tmdbId, resourceType (115/magnet/ed2k/video)
  • Obtener recursos de serie de televisión (getTVResources): Obtiene recursos de disco en la nube de una serie de televisión.
    • Entrada: tmdbId
  • Obtener recursos de temporada de serie (getTVSeasonResources): Obtiene recursos de una temporada específica.
    • Entrada: tmdbId, seasonNumber, resourceType
  • Obtener recursos de episodio de serie (getTVEpisodeResources): Obtiene recursos de un episodio específico.
    • Entrada: tmdbId, seasonNumber, episodeNumber, resourceType
  • Obtener recursos de persona (getPersonResources): Obtiene recursos de disco en la nube relacionados con una persona.
    • Entrada: tmdbId
  • Obtener recursos de colección (getCollectionResources): Obtiene recursos de disco en la nube de una colección de películas.
    • Entrada: tmdbId

Gestión de CMS

  • Agregar enlace de compartir 115 (addShareDown): Agrega el enlace de compartir 115 obtenido al sistema CMS para su transferencia.
    • Entrada: url

Inicio rápido

1. Requisitos del entorno

  • JDK 17+
  • Maven 3.6+

2. Instalación y configuración

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

Antes de ejecutar, debe configurar el archivo src/main/resources/application.yml con su clave de API y la configuración del 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. Compilación

mvn clean package

4. Ejecución

Use el siguiente comando para iniciar el servicio SSE (puerto predeterminado 8080):

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

5. Conexión del cliente

Conexión a través de Cherry Studio

  1. Abra la configuración de Cherry Studio y haga clic en "Servidores MCP".
  2. Haga clic en "Agregar" y configure lo siguiente:
    • Tipo: SSE
    • URL: http://localhost:8080/sse (si está implementado de forma remota, modifique la IP)
  3. Guarde la configuración.
  4. En Configuración -> Servicios de modelo, asegúrese de que "Llamada a funciones" (Function Calling) esté habilitado.
  5. Active el servicio MCP en la interfaz de conversación.
  6. Ahora puede preguntar directamente a la IA, por ejemplo:
    • "Busca la película 'The Matrix'"
    • "Ayúdame a encontrar los recursos de la primera temporada de 'Breaking Bad'"
    • "Transfiere este enlace 115 a mi CMS"

Licencia

MIT