C411 MCP-Server

Ein MCP-Server (Model Context Protocol) zum Suchen von Torrents auf c411.org, zum Abrufen von Torrent-Metadaten und Kommentaren sowie zum Herunterladen von .torrent-Dateien.

Inhaltsverzeichnis

• Funktionen

• Installation

• Verwendung

  • Starten des Servers

  • Authentifizierung

  • Verhalten bei Authentifizierungsfehlern

  • MCP-Client-Konfiguration

• Werkzeuge

  • search_c411

  • get_c411_torrent_info

  • get_c411_torrent_comments

  • download_c411_torrent

• Projektstruktur

• Entwicklung

• Hinweise

Funktionen

• Suchen von Torrents auf c411.org

• Abrufen detaillierter Torrent-Metadaten per infoHash

• Abrufen paginierter Torrent-Kommentare per infoHash

• Herunterladen von .torrent-Dateien per infoHash

• Automatische Wiederverwendung authentifizierter Sitzungen

• Wiederholung abgelaufener Authentifizierungen mit kurzer Verzögerung und begrenzter Anzahl an Versuchen

• Unterscheidung zwischen fehlenden Anmeldedaten, ungültigen Anmeldedaten und Fehlern im Wartungsmodus

• Rückgabe strukturierter Suchergebnisse mit Titeln, Größen, Seed-Anzahl und infoHash (sofern verfügbar)

Installation

npm install

Verwendung

Starten des Servers

Der Server verwendet standardmäßig den stdio-Transport:

npm run dev

Oder bauen und starten:

npm run build
npm start

Authentifizierung

C411.org erfordert eine Authentifizierung für den Zugriff auf Torrent-Listen. So aktivieren Sie die Anmeldung:

1. Setzen Sie die folgenden Umgebungsvariablen:

   • C411_USERNAME: Ihr c411.org-Benutzername

   • C411_PASSWORD: Ihr c411.org-Passwort

2. Der Server meldet sich automatisch an und hält die Sitzung aufrecht.

Ohne Anmeldedaten kann der Server möglicherweise keine Suchergebnisse abrufen.

Verhalten bei Authentifizierungsfehlern

Der Server versucht, einen spezifischeren Fehler zurückzugeben, wenn die Authentifizierung fehlschlägt:

• Fehlende Anmeldedaten: Fragt nach C411_USERNAME und C411_PASSWORD

• Ungültige Anmeldedaten: Meldet, dass Benutzername/Passwort abgelehnt wurden

• Wartungsmodus: Meldet, dass c411.org vorübergehend nicht verfügbar ist

• Netzwerk- oder Timeout-Probleme: Gibt einen bereinigten Transportfehler zurück, ohne Anmeldedaten zu protokollieren

HTTP-Anfragen haben ein Timeout von 10 Sekunden.

MCP-Client-Konfiguration

Um diesen Server mit einem MCP-Client (wie Claude Desktop) zu verwenden, fügen Sie ihn Ihrer Client-Konfiguration hinzu:

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

Für OpenCode konfigurieren Sie den Server in Ihrer OpenCode-Konfiguration unter mcp mit einem lokalen MCP-Eintrag:

{
  "$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 dokumentiert MCP-Server unter dem Schlüssel mcp, wobei lokale Server type: "local", ein command-Array und environment für Umgebungsvariablen verwenden.

Sie können ihn auch über die OpenCode-CLI hinzufügen:

opencode mcp add

Wählen Sie dann einen lokalen MCP-Server aus und geben Sie die entsprechenden Werte ein:

• name: c411

• type: local

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

• environment:

  • C411_USERNAME=ihr_benutzername

  • C411_PASSWORD=ihr_passwort

Anschließend können Sie mit folgendem Befehl überprüfen, ob er hinzugefügt wurde:

opencode mcp list

Werkzeuge

search_c411

Suchen Sie nach Torrents auf c411.org.

Parameter:

• query (string, erforderlich): Suchanfrage, getrimmt, 1 bis 200 Zeichen

• category (string, optional): Kategoriefilter. Einer der Werte 1, 2, 3, 4, 5, 6, 7, 10.

• subcat (string, optional): Unterkategoriefilter. Nur gültig, wenn category 1 ist.

• sortBy (string, optional): Sortierkriterien. Einer der Werte relevance, seeders, leechers, size, createdAt, name, completions, comments, category. Standard ist relevance.

• sortOrder (string, optional): Sortierreihenfolge. Einer der Werte asc, desc. Standard ist desc.

• page (number, optional): Seitennummer der Ergebnisse. Standard ist 1.

• perPage (number, optional): Anzahl der Ergebnisse pro Seite. Standard ist 25, maximal 100.

Rückgabe: Liste von Torrent-Ergebnissen mit Titeln, Größen, Seed-Anzahl und infoHash (sofern verfügbar).

list_my_c411_uploads

Listen Sie Torrents auf, die vom aktuell authentifizierten c411.org-Benutzer hochgeladen wurden.

Parameter:

• query (string, optional): Suchanfrage, getrimmt, 1 bis 200 Zeichen.

• category (string, optional): Kategoriefilter. Einer der Werte 1, 2, 3, 4, 5, 6, 7, 10.

• subcat (string, optional): Unterkategoriefilter. Nur gültig, wenn category 1 ist.

• sortBy (string, optional): Sortierkriterien. Einer der Werte relevance, seeders, leechers, size, createdAt, name, completions, comments, category. Standard ist relevance.

• sortOrder (string, optional): Sortierreihenfolge. Einer der Werte asc, desc. Standard ist desc.

• page (number, optional): Seitennummer der Ergebnisse. Standard ist 1.

• perPage (number, optional): Anzahl der Ergebnisse pro Seite. Standard ist 100, maximal 100.

Rückgabe: Liste der Torrent-Ergebnisse für die Uploads des aktuellen Benutzers, unter Verwendung der gleichen Struktur wie search_c411.

get_c411_torrent_info

Abrufen detaillierter Metadaten für einen Torrent auf c411.org.

Parameter:

• infoHash (string, erforderlich): Der 40-stellige Hex-infoHash des Torrents

Rückgabe: Strukturierte Torrent-Metadaten einschließlich Titel, Kategorie, Größe, Seeder- und Leecher-Anzahl, Anzahl der Fertigstellungen, Uploader, Erstellungsdatum, Dateiliste, TMDB-Daten (sofern verfügbar) und Vertrauensinformationen.

get_c411_torrent_comments

Abrufen paginierter Kommentare für einen Torrent auf c411.org.

Parameter:

• infoHash (string, erforderlich): Der 40-stellige Hex-infoHash des Torrents

• page (number, optional): Seitennummer der Kommentare. Standard ist 1.

• limit (number, optional): Anzahl der Kommentare pro Seite. Standard ist 20, maximal 100.

Rückgabe: Strukturierte Kommentarabfrageergebnisse mit Paginierungsmetadaten und normalisierten Kommentareinträgen, einschließlich HTML-Inhalt, Klartextinhalt, Autoreninformationen, Zeitstempeln und Antwortzielen (sofern vorhanden).

download_c411_torrent

Laden Sie eine .torrent-Datei von c411.org herunter und speichern Sie sie auf der Festplatte.

Parameter:

• infoHash (string, erforderlich): Der 40-stellige Hex-infoHash des Torrents

• outputDir (string, optional): Verzeichnis, in dem die .torrent-Datei gespeichert werden soll. Standard ist /tmp.

Rückgabe: Der vollständige Pfad der gespeicherten .torrent-Datei.

Beispiel:

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

Projektstruktur

• src/index.ts: Nur Bootstrap; erstellt den MCP-Server und startet stdio

• src/c411-client.ts: c411-Authentifizierung, Wiederholungsversuche, Suche, Torrent-Info, Kommentare und Download-Logik

• src/register-tools.ts: MCP-Werkzeugregistrierung

• src/formatters.ts: Formatierungs- und Normalisierungshilfen für Suche, Torrent-Info und Kommentare

• src/http-response-utils.ts: Hilfsprogramme für die Antwortanalyse und Wartungserkennung

• src/http-client.ts: Isolierte Axios + Cookie-Jar-Einrichtung

• src/schemas.ts: Zod-Werkzeugschemata

• src/types.ts: Gemeinsame TypeScript-Typen

Entwicklung

• npm run dev: Ausführen im Entwicklungsmodus mit Hot-Reload

• npm run build: Kompilieren von TypeScript zu JavaScript

• npm start: Ausführen des kompilierten Servers

Hinweise

• Dieser Server ist nur für den persönlichen Gebrauch bestimmt

• Respektieren Sie die Nutzungsbedingungen von c411.org

• Bewahren Sie Ihre Anmeldedaten sicher auf

• Der Scraper muss möglicherweise aktualisiert werden, wenn sich die Website-Struktur ändert