kinozal-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kinozal-mcp search torrents for interstellar"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Kinozal MCP Server
MCP (Model Context Protocol) сервер для работы с торрент-трекером kinozal.tv.
Возможности
🔍 Поиск торрентов - поиск по названию с возможностью пагинации
📊 Подробная информация - получение детальных данных о торренте (название, год, жанр, качество, размер, сиды/пиры)
⬇️ Скачивание торрент-файлов - загрузка .torrent файлов на компьютер (требуется авторизация)
Related MCP server: Fr Torrent Search MCP Server
Установка
Быстрый запуск через npx (рекомендуется)
Не требует установки, запускается напрямую:
npx kinozal-mcpГлобальная установка
npm install -g kinozal-mcp
kinozal-mcpЛокальная установка
npm install kinozal-mcpУстановка из исходников
Клонируйте репозиторий:
git clone <repository-url>
cd kinozal_mcpУстановите зависимости:
npm installСоберите проект:
npm run buildНастройка авторизации
Для скачивания торрентов настройте переменные окружения:
KINOZAL_USERNAME=ваш_логин
KINOZAL_PASSWORD=ваш_парольЭто позволит скачивать торренты без передачи логина/пароля в каждом запросе.
Использование
Настройка в Claude Desktop
Добавьте следующую конфигурацию в файл claude_desktop_config.json:
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Вариант 1: Использование npx (рекомендуется)
{
"mcpServers": {
"kinozal": {
"command": "npx",
"args": ["kinozal-mcp"],
"env": {
"KINOZAL_USERNAME": "ваш_логин",
"KINOZAL_PASSWORD": "ваш_пароль"
}
}
}
}Вариант 2: Локальная установка
{
"mcpServers": {
"kinozal": {
"command": "node",
"args": ["/путь/к/проекту/kinozal_mcp/build/index.js"],
"env": {
"KINOZAL_USERNAME": "ваш_логин",
"KINOZAL_PASSWORD": "ваш_пароль"
}
}
}
}Замените путь на актуальный путь к вашему проекту.
Использование с другими MCP клиентами
Просто запустите сервер:
npx kinozal-mcpДоступные инструменты
1. search_torrents
Поиск торрентов по запросу.
Параметры:
query(string, обязательный) - поисковый запрос (название фильма/сериала/музыки)page(number, опциональный) - номер страницы (по умолчанию: 0)
Пример:
{
"query": "matrix",
"page": 0
}Возвращает:
[
{
"id": "1980167",
"title": "Матрица (Трилогия) / The Matrix: Trilogy / 1999-2003",
"size": "42.85 ГБ",
"seeds": 12,
"peers": 3,
"comments": 11,
"uploadDate": "23.12.2025 в 05:48",
"uploader": "vitalikmd",
"category": "13"
}
]2. get_torrent_details
Получение подробной информации о торренте.
Параметры:
id(string, обязательный) - ID торрента из kinozal.tv
Пример:
{
"id": "1980167"
}Возвращает:
{
"id": "1980167",
"title": "Матрица: Трилогия",
"originalTitle": "The Matrix. Trilogy",
"year": "1999-2003",
"genre": "Фантастика, антиутопия, триллер",
"director": "Лилли Вачовски, Лана Вачовски",
"cast": "Киану Ривз, Лоуренс Фишборн...",
"description": "Фильм изображает будущее...",
"quality": "HDDVDRip (1080p)",
"video": "MPEG-H HEVC, ~ 8000 Кбит/с, 1920x800",
"audio": "...",
"size": "42.85 ГБ",
"seeds": 12,
"peers": 3,
"uploadDate": "10 июня 2023 в 08:06",
"updateDate": "23 декабря 2025 в 05:48"
}3. download_torrent
Скачивание .torrent файла (требуется учетная запись на kinozal.tv).
Параметры:
id(string, обязательный) - ID торрентаoutputPath(string, обязательный) - путь для сохранения .torrent файлаusername(string, опциональный) - логин на kinozal.tv (если не задан в .env)password(string, опциональный) - пароль на kinozal.tv (если не задан в .env)
Пример 1: Использование переменных окружения (рекомендуется)
{
"id": "1980167",
"outputPath": "/Users/user/Downloads/matrix.torrent"
}Пример 2: Передача учетных данных напрямую
{
"id": "1980167",
"outputPath": "/Users/user/Downloads/matrix.torrent",
"username": "your_username",
"password": "your_password"
}Возвращает:
{
"success": true,
"message": "Torrent file downloaded successfully",
"path": "/Users/user/Downloads/matrix.torrent"
}Структура проекта
kinozal_mcp/
├── src/
│ ├── index.ts # Основной MCP сервер
│ ├── kinozal.ts # Функции для работы с kinozal.tv
│ └── cookie-jar.ts # Управление cookies для авторизации
├── build/ # Скомпилированные JS файлы
├── package.json
├── tsconfig.json
└── README.mdРазработка
Для разработки с автоматической перекомпиляцией:
npm run watchТехнические детали
Парсинг HTML: Используется cheerio для извлечения данных из страниц
Кодировка: kinozal.tv использует Windows-1251, данные автоматически конвертируются в UTF-8
Авторизация: Для скачивания торрент-файлов используется сессионная авторизация через cookies
MCP SDK: Сервер построен на @modelcontextprotocol/sdk
Примечания
Для использования функции
download_torrentнеобходима регистрация на kinozal.tvРекомендуется: Настройте
.envфайл с учетными данными для удобства и безопасностиУчетные данные можно передавать как через
.env, так и напрямую в параметрах инструментаСервер использует публичные страницы kinozal.tv и не нарушает правила трекера
Скачивание торрентов возможно только после авторизации
Лицензия
MIT
Available Tools
3 toolsdownload_torrentA
Download .torrent file to specified path. Credentials can be provided via arguments or environment variables (KINOZAL_USERNAME, KINOZAL_PASSWORD).
Inputs: id (required), outputPath (required), username, password.
get_torrent_detailsA
Get detailed information about a specific torrent by ID
Inputs: id (required).
search_torrentsB
Search for torrents on kinozal.tv by query. Returns list of torrents with title, size, seeds, peers and ID.
Inputs: query (required), page.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a distinct purpose: search, get details, and download. No overlap or ambiguity.
All tools use consistent verb_noun snake_case pattern (download_torrent, get_torrent_details, search_torrents).
3 tools is well-scoped for a torrent server, covering search, details, and download without unnecessary extras.
Covers core torrent operations, but lacks features like category browsing or upload. Minor gap.
Maintenance
Related MCP Connectors
MCP-сервер для поиска русскоязычных книг, получения карточек и кандидатов для рекомендаций.
MCP server for the Vulners.com API
MCP server for the FFmpeg Micro video transcoding API — create, monitor, download transcodes.
Related MCP Servers
- AlicenseAqualityBmaintenanceA Python MCP server that allows programmatic interaction to find torrents programmatically on ThePirateBay, Nyaa and YggTorrent.7151 PyPI45PythonMIT
- AlicenseBqualityFmaintenanceA Python MCP server that allows programmatic interaction to find torrents programmatically on YggTorrent and La Cale.42MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for reelgrep - browse and search your local video library from any MCP client.8 npmMIT
- AlicenseAqualityDmaintenanceMCP server for the OMDb API - search movies, series, and episodes from any MCP-compatible client.512 PyPIMIT