NullBR MCP Server

NullBR MCP Server(nullbr foi encerrado)

Introdução

A API de busca de títulos da NullBR API agora é compatível com o protocolo MCP, permitindo que qualquer assistente de agente inteligente que suporte o protocolo MCP (como Claude, Cursor, Cherry Studio, etc.) se conecte rapidamente à API NullBR, pesquise e obtenha informações de recursos de filmes e TV, e possa transferi-los para o CMS.

Este projeto depende do desenvolvimento de MCP Java SDK, implementado com base no framework Spring AI. Utiliza o protocolo SSE (Server-Sent Events), com suporte a respostas em streaming.

Lista de Ferramentas

Este projeto oferece ferramentas abrangentes de consulta e gerenciamento de recursos de filmes e TV:

Pesquisa e Detalhes

• Pesquisa de Mídia (searchMedia): Pesquise filmes, séries de TV, pessoas ou coleções.
  • Entrada: query (palavra-chave), page (número da página, opcional)
• Obter Lista (getList): Obtém detalhes de uma lista específica.
  • Entrada: listId, page
• Obter Detalhes do Filme (getMovieInfo): Obtém metadados detalhados do filme.
  • Entrada: tmdbId
• Obter Detalhes da Série de TV (getTVInfo): Obtém metadados detalhados da série de TV.
  • Entrada: tmdbId
• Obter Detalhes da Temporada (getTVSeasonInfo): Obtém detalhes de uma temporada específica.
  • Entrada: tmdbId, seasonNumber
• Obter Detalhes do Episódio (getTVEpisodeInfo): Obtém detalhes de um episódio específico.
  • Entrada: tmdbId, seasonNumber, episodeNumber
• Obter Informações da Pessoa (getPersonInfo): Obtém detalhes do elenco e equipe.
  • Entrada: tmdbId, page
• Obter Informações da Coleção de Filmes (getCollectionInfo): Obtém detalhes da coleção de filmes da série.
  • Entrada: tmdbId

Obtenção de Recursos

• Obter Recursos do Filme (getMovieResources): Obtém recursos de download/reprodução do filme.
  • Entrada: tmdbId, resourceType (115/magnet/ed2k/video)
• Obter Recursos da Série de TV (getTVResources): Obtém recursos de nuvem da série de TV.
  • Entrada: tmdbId
• Obter Recursos da Temporada (getTVSeasonResources): Obtém recursos de uma temporada específica.
  • Entrada: tmdbId, seasonNumber, resourceType
• Obter Recursos do Episódio (getTVEpisodeResources): Obtém recursos de um episódio específico.
  • Entrada: tmdbId, seasonNumber, episodeNumber, resourceType
• Obter Recursos da Pessoa (getPersonResources): Obtém recursos de nuvem relacionados à pessoa.
  • Entrada: tmdbId
• Obter Recursos da Coleção (getCollectionResources): Obtém recursos de nuvem da coleção de filmes.
  • Entrada: tmdbId

Gerenciamento de CMS

• Adicionar Link de Compartilhamento 115 (addShareDown): Adiciona o link de compartilhamento 115 obtido ao sistema CMS para transferência.
  • Entrada: url

Início Rápido

1. Requisitos de Ambiente

• JDK 17+
• Maven 3.6+

2. Instalação e Configuração

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

Antes de executar, você precisa configurar o arquivo src/main/resources/application.yml, preenchendo sua chave de API e configuração do 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. Compilação

mvn clean package

4. Execução

Use o seguinte comando para iniciar o serviço SSE (porta padrão 8080):

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

5. Integração com Cliente

Integração via Cherry Studio

1. Abra as configurações do Cherry Studio e clique em "Servidores MCP".
2. Clique em "Adicionar" e configure da seguinte forma:
   • Tipo: SSE
   • URL: http://localhost:8080/sse (se implantado remotamente, altere o IP)
3. Salve a configuração.
4. Em Configurações -> Serviços de Modelo, certifique-se de que "Chamada de Função" (Function Calling) esteja habilitado.
5. Ative o serviço MCP na interface de conversa.
6. Agora você pode perguntar diretamente à IA, por exemplo:
   • "Pesquisar o filme 'Matrix'"
   • "Me ajude a encontrar os recursos da primeira temporada de 'Breaking Bad'"
   • "Transfira este link 115 para o meu CMS"

Licença

MIT