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.
Related MCP server: RuTracker MCP Server
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)
npm installDer Server verwendet standardmäßig den stdio-Transport:
npm run devOder bauen und starten:
npm run build
npm startC411.org erfordert eine Authentifizierung für den Zugriff auf Torrent-Listen. So aktivieren Sie die Anmeldung:
Setzen Sie die folgenden Umgebungsvariablen:
C411_USERNAME: Ihr c411.org-Benutzername
C411_PASSWORD: Ihr c411.org-Passwort
Der Server meldet sich automatisch an und hält die Sitzung aufrecht.
Ohne Anmeldedaten kann der Server möglicherweise keine Suchergebnisse abrufen.
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.
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 addWä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 listSuchen 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).
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.
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.
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).
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"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
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
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
Download a .torrent file from c411.org by its infoHash and save it to disk.
| Name | Required | Description | Default |
|---|---|---|---|
| infoHash | Yes | The 40-character hex infoHash of the torrent | |
| outputDir | No | Directory where the .torrent file should be saved. Defaults to /tmp. |
| Name | Required | Description |
|---|---|---|
| error | No | |
| success | Yes | |
| filename | No | |
| savedPath | No |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full disclosure burden. Successfully discloses the side effect ('save to disk'), indicating filesystem mutation. However, lacks details on idempotency, network requirements, error handling (e.g., invalid hash), or output structure despite having an output schema available.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single, dense sentence with zero waste. Front-loaded with the action verb, immediately communicating purpose. Every clause earns its place: source domain, identification method, and persistence mechanism are all efficiently packed.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Appropriate for a 2-parameter tool with full schema coverage and existing output schema. Covers the essential 'what' and 'where to' aspects. Minor gap: could briefly mention the return value indicates success/failure or file path since annotations are absent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, establishing a baseline of 3. Description adds value by clarifying the infoHash's role in identifying the specific torrent to retrieve ('by its infoHash'), and implicitly connects the outputDir to the 'save to disk' action. Could mention the default /tmp behavior explicitly, but overall adds meaningful usage context.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Excellent specificity: states the verb ('Download'), resource ('.torrent file'), source ('c411.org'), identifier ('by its infoHash'), and side effect ('save to disk'). Clearly distinguishes from siblings 'get_c411_torrent_info' and 'search_c411' through the explicit action of downloading vs retrieving metadata or searching.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides implied usage context through the specific action ('download... save to disk'), but lacks explicit when-to-use guidance contrasting with siblings. Does not state prerequisites (e.g., valid c411.org infoHash) or error conditions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Get comments for a c411.org torrent by its infoHash.
| Name | Required | Description | Default |
|---|---|---|---|
| infoHash | Yes | The 40-character hex infoHash of the torrent | |
| page | No | Comment page number. Defaults to 1. | |
| limit | No | Number of comments per page. Defaults to 20. |
| Name | Required | Description |
|---|---|---|
| page | Yes | |
| error | No | |
| limit | Yes | |
| total | No | |
| comments | Yes | |
| infoHash | Yes | |
| totalPages | No | |
| resultCount | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, yet description fails to disclose behavioral traits: no mention of pagination behavior (despite page/limit params), rate limits, authentication requirements for c411.org, or handling of empty comment sets. 'Get' implies read-only but does not confirm it.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single efficient sentence of 9 words. Front-loaded with verb, zero redundancy, every token carries meaning (domain, resource, identifier).
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Adequate for a read operation given 100% schema coverage and existence of output schema (which handles return value documentation). Could be improved by mentioning pagination or empty state handling, but functional for tool selection.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, establishing baseline 3. Description adds minimal semantics beyond schema—only linking infoHash to the retrieval operation via 'by its infoHash'. Schema already documents the 40-character hex pattern and pagination defaults.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Specific verb 'Get' + resource 'comments for a c411.org torrent' clearly identifies the operation. Explicitly distinguishes from siblings: targets comments (not download, info metadata, or search index) and specifies the external domain.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides clear context by identifying the specific resource (comments) and required identifier (infoHash), implicitly distinguishing from sibling torrent operations. However, lacks explicit workflow guidance (e.g., 'use after search_c411 to retrieve infoHash').
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Get detailed metadata for a c411.org torrent by its infoHash.
| Name | Required | Description | Default |
|---|---|---|---|
| infoHash | Yes | The 40-character hex infoHash of the torrent |
| Name | Required | Description |
|---|---|---|
| size | No | |
| tmdb | No | |
| error | No | |
| files | No | |
| title | No | |
| trust | No | |
| status | No | |
| seeders | No | |
| success | No | |
| category | No | |
| infoHash | Yes | |
| leechers | No | |
| uploader | No | |
| createdAt | No | |
| fileCount | No | |
| sizeBytes | No | |
| completions | No | |
| isExclusive | No | |
| isFreeleech | No | |
| subcategory | No | |
| descriptionHtml | No | |
| lowBitrateWarning | No |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full disclosure burden but only states it's a read operation ('Get') targeting metadata. It fails to disclose what 'detailed metadata' specifically includes, error conditions for invalid hashes, rate limits, or caching behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence of 10 words with zero waste. Front-loaded with action verb 'Get', immediately identifies the resource (c411.org torrent metadata), and specifies the lookup key (infoHash). Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Appropriate for a simple 1-parameter tool with output schema present (no need to describe return values). Sufficient for invocation but could be improved by explicitly mentioning the sibling workflow (obtain hash via search_c411 first).
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with the infoHash parameter fully documented including pattern validation. The description mentions 'by its infoHash' but adds no semantic meaning beyond the schema's existing '40-character hex infoHash' description, meeting the baseline for high-coverage schemas.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses specific verb 'Get' with clear resource 'detailed metadata for a c411.org torrent' and scope identifier 'by its infoHash'. This clearly distinguishes from sibling download_c411_torrent (content vs metadata), get_c411_torrent_comments (metadata vs comments), and search_c411 (specific hash lookup vs broad search).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'by its infoHash' implicitly signals you must already possess the hash to use this tool, distinguishing it from search_c411. However, it lacks explicit guidance on the prerequisite workflow (search first, then this tool) or when to prefer alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Search for torrents on c411.org
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query for torrents | |
| sortBy | No | Sort criteria for the search results. Defaults to relevance. | relevance |
| sortOrder | No | Sort order for the search results. Defaults to desc. | desc |
| page | No | Result page number. Defaults to 1. | |
| perPage | No | Number of results per page. Defaults to 25. |
| Name | Required | Description |
|---|---|---|
| page | Yes | |
| error | No | |
| query | Yes | |
| total | No | |
| perPage | Yes | |
| results | Yes | |
| totalPages | No | |
| resultCount | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden for behavioral disclosure. It states nothing about network requirements, rate limits, authentication, idempotency, or whether results are cached. The minimal description offers no behavioral context beyond the basic action.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The single sentence 'Search for torrents on c411.org' is appropriately sized with zero redundancy. It is front-loaded with the action and contains no filler text, making it efficiently scannable.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the 100% parameter schema coverage and presence of an output schema, the description does not need to elaborate on return values or parameter details. However, it lacks mention of the typical workflow (search → download/info) that would complete the context for an agent selecting among the four related tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 100% schema description coverage, the input schema fully documents all 5 parameters (query, sortBy, sortOrder, page, perPage). The description adds no additional semantic information beyond what the schema provides, which warrants the baseline score for high-coverage schemas.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('Search') and resource ('torrents on c411.org'), clearly identifying the tool's function. However, it does not explicitly differentiate from siblings like 'get_c411_torrent_info' (which retrieves specific torrent details by ID rather than searching).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It fails to mention that search results are typically prerequisite for using sibling tools like 'download_c411_torrent' or 'get_c411_torrent_info', or that this is the entry point for discovery.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
v1.0.0download_c411_torrentget_c411_torrent_commentsget_c411_torrent_infosearch_c411Scored across 4 tools
Each tool has a clearly distinct purpose: downloading torrent files, retrieving comments, getting metadata, and searching. The descriptions specify unique actions on the same domain (c411.org torrents), with no overlap that would cause misselection.
All tool names follow a consistent verb_noun pattern with 'c411' as a prefix (e.g., download_c411_torrent, search_c411). The naming is uniform, using snake_case throughout and clear action descriptors.
With 4 tools, the server is well-scoped for interacting with a torrent search site. Each tool serves a distinct function (search, info, comments, download), making the count appropriate and efficient for the domain.
The toolset covers core operations for torrent discovery and retrieval (search, get info, get comments, download), with no obvious dead ends. A minor gap might be the lack of upload or management tools, but for a client-focused server, this is reasonable.
Tor gateway for AI agents: fetch URLs and rotate circuits through Tor, Bitcoin-settled.
Search the Wayback Machine and IA library (40M+ items), fetch snapshots, item metadata, and text.
Route HTTP requests through the Tor network. Rotating exit IPs, .onion support, no body logging.
Search, URL-to-markdown, change detection, live data, x402 trust tools. USDC pay-per-call.