MCP-сервер C411

MCP-сервер (Model Context Protocol) для поиска торрентов на c411.org, получения метаданных и комментариев к торрентам, а также скачивания файлов .torrent.

Содержание

• Возможности

• Установка

• Использование

  • Запуск сервера

  • Аутентификация

  • Поведение при сбое аутентификации

  • Настройка MCP-клиента

• Инструменты

  • search_c411

  • get_c411_torrent_info

  • get_c411_torrent_comments

  • download_c411_torrent

• Структура проекта

• Разработка

• Примечания

Возможности

• Поиск торрентов на c411.org

• Получение подробных метаданных торрента по infoHash

• Получение постраничных комментариев к торренту по infoHash

• Скачивание файлов .torrent по infoHash

• Автоматическое повторное использование аутентифицированных сессий

• Повторные попытки при истечении срока действия авторизации с небольшой задержкой и ограничением количества попыток

• Различение отсутствующих учетных данных, неверных учетных данных и ошибок режима обслуживания

• Возврат структурированных результатов поиска с названиями, размерами, количеством сидов и infoHash (если доступно)

Установка

npm install

Использование

Запуск сервера

По умолчанию сервер использует транспорт stdio:

npm run dev

Или выполните сборку и запуск:

npm run build
npm start

Аутентификация

Для доступа к спискам торрентов на c411.org требуется аутентификация. Чтобы включить вход:

1. Установите следующие переменные окружения:

   • C411_USERNAME: Ваше имя пользователя на c411.org

   • C411_PASSWORD: Ваш пароль на c411.org

2. Сервер автоматически выполнит вход и будет поддерживать сессию.

Без учетных данных сервер может не получить результаты поиска.

Поведение при сбое аутентификации

Сервер пытается вернуть более конкретную ошибку при сбое аутентификации:

• Отсутствующие учетные данные: запрашивает C411_USERNAME и C411_PASSWORD

• Неверные учетные данные: сообщает, что имя пользователя/пароль были отклонены

• Режим обслуживания: сообщает, что c411.org временно недоступен

• Сетевые проблемы или тайм-ауты: возвращает очищенную ошибку транспорта без логирования учетных данных

HTTP-запросы прерываются по тайм-ауту через 10 секунд.

Настройка MCP-клиента

Чтобы использовать этот сервер с MCP-клиентом (например, Claude Desktop), добавьте в конфигурацию клиента:

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

Для OpenCode настройте сервер в конфигурации OpenCode в разделе mcp, используя локальную запись MCP:

{
  "$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 документирует MCP-серверы под ключом mcp, где локальные серверы используют type: "local", массив command и environment для переменных окружения.

Вы также можете добавить его через CLI OpenCode:

opencode mcp add

Затем выберите локальный MCP-сервер и введите соответствующие значения:

• name: c411

• type: local

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

• environment:

  • C411_USERNAME=your_username

  • C411_PASSWORD=your_password

После этого вы можете проверить, что он был добавлен, с помощью:

opencode mcp list

Инструменты

search_c411

Поиск торрентов на c411.org.

Параметры:

• query (строка, обязательно): Поисковый запрос, обрезанный, от 1 до 200 символов

• category (строка, опционально): Фильтр категории. Одно из 1, 2, 3, 4, 5, 6, 7, 10.

• subcat (строка, опционально): Фильтр подкатегории. Действительно только если category равно 1.

• sortBy (строка, опционально): Критерий сортировки. Одно из relevance, seeders, leechers, size, createdAt, name, completions, comments, category. По умолчанию relevance.

• sortOrder (строка, опционально): Порядок сортировки. Одно из asc, desc. По умолчанию desc.

• page (число, опционально): Номер страницы результатов. По умолчанию 1.

• perPage (число, опционально): Количество результатов на страницу. По умолчанию 25, максимум 100.

Возвращает: Список результатов торрентов с названиями, размерами, количеством сидов и infoHash (если доступно).

list_my_c411_uploads

Список торрентов, загруженных текущим аутентифицированным пользователем c411.org.

Параметры:

• query (строка, опционально): Поисковый запрос, обрезанный, от 1 до 200 символов.

• category (строка, опционально): Фильтр категории. Одно из 1, 2, 3, 4, 5, 6, 7, 10.

• subcat (строка, опционально): Фильтр подкатегории. Действительно только если category равно 1.

• sortBy (строка, опционально): Критерий сортировки. Одно из relevance, seeders, leechers, size, createdAt, name, completions, comments, category. По умолчанию relevance.

• sortOrder (строка, опционально): Порядок сортировки. Одно из asc, desc. По умолчанию desc.

• page (число, опционально): Номер страницы результатов. По умолчанию 1.

• perPage (число, опционально): Количество результатов на страницу. По умолчанию 100, максимум 100.

Возвращает: Список результатов торрентов для загрузок текущего пользователя, используя ту же структуру, что и search_c411.

get_c411_torrent_info

Получение подробных метаданных для торрента на c411.org.

Параметры:

• infoHash (строка, обязательно): 40-символьный шестнадцатеричный infoHash торрента

Возвращает: Структурированные метаданные торрента, включая название, категорию, размер, количество сидов и личеров, количество завершений, загрузчика, дату создания, список файлов, данные TMDB (если доступны) и информацию о доверии.

get_c411_torrent_comments

Получение постраничных комментариев к торренту на c411.org.

Параметры:

• infoHash (строка, обязательно): 40-символьный шестнадцатеричный infoHash торрента

• page (число, опционально): Номер страницы комментариев. По умолчанию 1.

• limit (число, опционально): Количество комментариев на страницу. По умолчанию 20, максимум 100.

Возвращает: Структурированные результаты комментариев с метаданными пагинации и нормализованными записями комментариев, включая HTML-контент, текстовый контент, информацию об авторе, временные метки и цели ответов (если присутствуют).

download_c411_torrent

Скачивание файла .torrent с c411.org и сохранение его на диск.

Параметры:

• infoHash (строка, обязательно): 40-символьный шестнадцатеричный infoHash торрента

• outputDir (строка, опционально): Директория, в которую должен быть сохранен файл .torrent. По умолчанию /tmp.

Возвращает: Полный путь к сохраненному файлу .torrent.

Пример:

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

Структура проекта

• src/index.ts: только начальная загрузка; создает MCP-сервер и запускает stdio

• src/c411-client.ts: логика аутентификации c411, повторных попыток, поиска, информации о торрентах, комментариев и скачивания

• src/register-tools.ts: регистрация инструментов MCP

• src/formatters.ts: вспомогательные функции форматирования и нормализации для поиска, информации о торрентах и комментариев

• src/http-response-utils.ts: вспомогательные функции для парсинга ответов и обнаружения режима обслуживания

• src/http-client.ts: изолированная настройка Axios + cookie-jar

• src/schemas.ts: схемы инструментов Zod

• src/types.ts: общие типы TypeScript

Разработка

• npm run dev: Запуск в режиме разработки с горячей перезагрузкой

• npm run build: Компиляция TypeScript в JavaScript

• npm start: Запуск скомпилированного сервера

Примечания

• Этот сервер предназначен только для личного использования

• Соблюдайте условия обслуживания c411.org

• Храните свои учетные данные в безопасности

• Скрапер может потребовать обновлений, если структура веб-сайта изменится