Servidor MCP C411

Un servidor MCP (Model Context Protocol) para buscar torrents en c411.org, obtener metadatos y comentarios de torrents, y descargar archivos .torrent.

Tabla de contenidos

• Características

• Instalación

• Uso

  • Ejecución del servidor

  • Autenticación

  • Comportamiento ante fallos de autenticación

  • Configuración del cliente MCP

• Herramientas

  • search_c411

  • get_c411_torrent_info

  • get_c411_torrent_comments

  • download_c411_torrent

• Estructura del proyecto

• Desarrollo

• Notas

Características

• Buscar torrents en c411.org

• Obtener metadatos detallados de torrents mediante infoHash

• Obtener comentarios de torrents paginados mediante infoHash

• Descargar archivos .torrent mediante infoHash

• Reutilizar sesiones autenticadas automáticamente

• Reintentar la autenticación expirada con un pequeño retraso y un límite de reintentos

• Distinguir entre credenciales faltantes, credenciales no válidas y fallos por modo de mantenimiento

• Devolver resultados de búsqueda estructurados con títulos, tamaños, recuento de semillas y infoHash cuando esté disponible

Instalación

npm install

Uso

Ejecución del servidor

El servidor utiliza el transporte stdio por defecto:

npm run dev

O compila y ejecuta:

npm run build
npm start

Autenticación

C411.org requiere autenticación para acceder a los listados de torrents. Para habilitar el inicio de sesión:

1. Establece las siguientes variables de entorno:

   • C411_USERNAME: Tu nombre de usuario de c411.org

   • C411_PASSWORD: Tu contraseña de c411.org

2. El servidor iniciará sesión automáticamente y mantendrá la sesión.

Sin credenciales, es posible que el servidor no pueda recuperar resultados de búsqueda.

Comportamiento ante fallos de autenticación

El servidor intenta devolver un error más específico cuando falla la autenticación:

• Credenciales faltantes: solicita C411_USERNAME y C411_PASSWORD

• Credenciales no válidas: informa que el nombre de usuario/contraseña fueron rechazados

• Modo de mantenimiento: informa que c411.org no está disponible temporalmente

• Problemas de red o tiempo de espera: devuelve un error de transporte saneado sin registrar las credenciales

Las solicitudes HTTP tienen un tiempo de espera de 10 segundos.

Configuración del cliente MCP

Para usar este servidor con un cliente MCP (como Claude Desktop), añádelo a la configuración de tu cliente:

{
  "mcpServers": {
    "c411": {
      "command": "node",
      "args": ["/path/to/c411-mcp-server/build/index.js"],
      "env": {
        "C411_USERNAME": "your_username",
        "C411_PASSWORD": "your_password"
      }
    }
  }
}

Para OpenCode, configura el servidor en tu configuración de OpenCode bajo mcp usando una entrada MCP local:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "c411": {
      "type": "local",
      "command": ["node", "/path/to/c411-mcp-server/build/index.js"],
      "enabled": true,
      "environment": {
        "C411_USERNAME": "your_username",
        "C411_PASSWORD": "your_password"
      }
    }
  }
}

OpenCode documenta los servidores MCP bajo la clave mcp, con servidores locales usando type: "local", una matriz command y environment para variables de entorno.

También puedes añadirlo desde la CLI de OpenCode:

opencode mcp add

Luego elige un servidor MCP local e introduce los valores equivalentes:

• name: c411

• type: local

• command: node /path/to/c411-mcp-server/build/index.js

• environment:

  • C411_USERNAME=tu_usuario

  • C411_PASSWORD=tu_contraseña

Después, puedes verificar que se añadió con:

opencode mcp list

Herramientas

search_c411

Busca torrents en c411.org.

Parámetros:

• query (string, requerido): Consulta de búsqueda, recortada, de 1 a 200 caracteres

• category (string, opcional): Filtro de categoría. Uno de 1, 2, 3, 4, 5, 6, 7, 10.

• subcat (string, opcional): Filtro de subcategoría. Solo válido cuando category es 1.

• sortBy (string, opcional): Criterios de ordenación. Uno de relevance, seeders, leechers, size, createdAt, name, completions, comments, category. Por defecto relevance.

• sortOrder (string, opcional): Orden de clasificación. Uno de asc, desc. Por defecto desc.

• page (number, opcional): Número de página de resultados. Por defecto 1.

• perPage (number, opcional): Número de resultados por página. Por defecto 25, máximo 100.

Retorna: Lista de resultados de torrents con títulos, tamaños, recuento de semillas y infoHash cuando esté disponible.

list_my_c411_uploads

Lista los torrents subidos por el usuario autenticado actual de c411.org.

Parámetros:

• query (string, opcional): Consulta de búsqueda, recortada, de 1 a 200 caracteres.

• category (string, opcional): Filtro de categoría. Uno de 1, 2, 3, 4, 5, 6, 7, 10.

• subcat (string, opcional): Filtro de subcategoría. Solo válido cuando category es 1.

• sortBy (string, opcional): Criterios de ordenación. Uno de relevance, seeders, leechers, size, createdAt, name, completions, comments, category. Por defecto relevance.

• sortOrder (string, opcional): Orden de clasificación. Uno de asc, desc. Por defecto desc.

• page (number, opcional): Número de página de resultados. Por defecto 1.

• perPage (number, opcional): Número de resultados por página. Por defecto 100, máximo 100.

Retorna: Lista de resultados de torrents para las subidas del usuario actual, usando la misma estructura que search_c411.

get_c411_torrent_info

Obtén metadatos detallados para un torrent en c411.org.

Parámetros:

• infoHash (string, requerido): El infoHash hexadecimal de 40 caracteres del torrent

Retorna: Metadatos estructurados del torrent incluyendo título, categoría, tamaño, recuento de semillas y sanguijuelas, recuento de finalizaciones, subidor, fecha de creación, lista de archivos, datos de TMDB cuando estén disponibles e información de confianza.

get_c411_torrent_comments

Obtén comentarios paginados para un torrent en c411.org.

Parámetros:

• infoHash (string, requerido): El infoHash hexadecimal de 40 caracteres del torrent

• page (number, opcional): Número de página de comentarios. Por defecto 1.

• limit (number, opcional): Número de comentarios por página. Por defecto 20, máximo 100.

Retorna: Resultados de comentarios estructurados con metadatos de paginación y entradas de comentarios normalizadas, incluyendo contenido HTML, contenido de texto plano, información del autor, marcas de tiempo y objetivos de respuesta cuando estén presentes.

download_c411_torrent

Descarga un archivo .torrent desde c411.org y guárdalo en el disco.

Parámetros:

• infoHash (string, requerido): El infoHash hexadecimal de 40 caracteres del torrent

• outputDir (string, opcional): Directorio donde se debe guardar el archivo .torrent. Por defecto /tmp.

Retorna: La ruta completa del archivo .torrent guardado.

Ejemplo:

infoHash: "178a3516f248e45f9857abbc2cbc8a8b20f29815"
outputDir: "/tmp"

Estructura del proyecto

• src/index.ts: solo arranque; crea el servidor MCP e inicia stdio

• src/c411-client.ts: autenticación de c411, reintentos, búsqueda, información de torrents, comentarios y lógica de descarga

• src/register-tools.ts: registro de herramientas MCP

• src/formatters.ts: ayudantes de formato y normalización para búsqueda, información de torrents y comentarios

• src/http-response-utils.ts: ayudantes de análisis de respuesta y detección de mantenimiento

• src/http-client.ts: configuración aislada de Axios + cookie-jar

• src/schemas.ts: esquemas de herramientas Zod

• src/types.ts: tipos de TypeScript compartidos

Desarrollo

• npm run dev: Ejecutar en modo desarrollo con recarga en caliente

• npm run build: Compilar TypeScript a JavaScript

• npm start: Ejecutar el servidor compilado

Notas

• Este servidor es solo para uso personal

• Respeta los términos de servicio de c411.org

• Mantén tus credenciales seguras

• El scraper puede necesitar actualizaciones si la estructura del sitio web cambia