MMCPMarkets
PT

philogicae/torrent-search-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

43 stars 9 forks Качество 82 Тренд 26MIT
Repository Install

MCP/API/WebUI для поиска торрентов

Обзор

Этот репозиторий предоставляет Python API / WebUI и сервер MCP (Model Context Protocol) для поиска торрентов программно на , , , , , и . Это позволяет легко интегрироваться в другие приложения или службы. Запустите его с помощью Docker, чтобы обойти общие проблемы DNS - API-обертка для , , , , , , , , и . - интерфейс сервера MCP для стандартизированной связи (stdio, sse, streamable-http). API-серверный интерфейс для альтернативного доступа HTTP (например, для прямых вызовов API или тестирования). Режим CLI для быстрого разового поиска непосредственно с терминала. Популярные торренты кэшируются в течение 2 минут для доставки веб-интерфейса; поиски никогда не кэшируются (сливаются только идентичные параллельные запросы), поэтому новые результаты появляются сразу. - В памяти 1-часовой, 5000-входной торрент-кэш, используемый только для разрешения магнитных ссылок через get torrent без пересечения. Магнитные ссылки всегда хранятся внутри; MCP скрывает их, если INCLUDE LINKS не соответствует действительности. Настраиваемая фильтрация источников через переменные среды.

Обзор (машинный перевод)

Этот репозиторий предоставляет API/WebUI Python и сервер MCP (Model Context Protocol) для поиска торрентов программно на ThePirateBay, 1337x, Nyaa, YTS, EZTV, FitGirl, SubsPlease и UIndex. Это позволяет легко интегрироваться в другие приложения или службы.

##Быстрый старт

Как использовать MCP-клиенты

Запустите его с Docker, чтобы обойти общие проблемы DNS

Поиск прямо из командной строки

Таблица содержимого

  • Особенности Поддерживаемые источники
  • Настройка
  • Предварительные условия
  • Конфигурация
  • Установка
  • Установка из PyPI (рекомендуется)
  • для местного развития
  • Для Докера
  • Использование
  • Как КЛИ Как Python Wrapper как MCP сервер как API сервер С помощью MCP-клиентов Пример с Девином Changelog
  • Вклад
  • Лицензия

Особенности

  • API-обертка для ThePirateBay, 1337x, Nyaa, YTS, EZTV, FitGirl, SubsPlease и UIndex.
  • Интерфейс сервера MCP (FastMCP 4), обслуживающий 2026-07-28 пересмотр протокола по stdio или потоковый HTTP (http), с автоматическим согласованием старых версий рукопожатия и устаревших транспортных псевдонимов (streamable-http, sse).
  • API-серверный интерфейс для альтернативного HTTP-доступа (e).

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Torrent Search MCP/API/WebUI

This repository provides a Python API/WebUI and an MCP (Model Context Protocol) server to find torrents programmatically on ThePirateBay, 1337x, Nyaa, YTS, EZTV, FitGirl, SubsPlease and UIndex. It allows for easy integration into other applications or services.

Quickstart

How to use it with MCP Clients

Run it with Docker to bypass common DNS issues

Search directly from the command line

uvx torrent-search-mcp --mode cli "sample show"

# MCP server over stdio (default)
uvx torrent-search-mcp --mode stdio

# MCP server over streamable HTTP (port 8000, endpoint /mcp)
uvx torrent-search-mcp --mode http

# MCP server over SSE (port 8000, endpoint /sse, legacy)
uvx torrent-search-mcp --mode sse

# Standalone API server (port 8000)
uvx torrent-search-mcp --mode api

Table of Contents

Features

  • API wrapper for ThePirateBay, 1337x, Nyaa, YTS, EZTV, FitGirl, SubsPlease and UIndex.
  • MCP server interface (FastMCP 4) serving the 2026-07-28 protocol revision over stdio or streamable HTTP (http), with automatic negotiation of older handshake revisions and legacy transport aliases (streamable-http, sse).
Открыть полный README на GitHub

Установка

uvx torrent-search-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { ... # with stdio (only requires uv) "torrent-search-mcp": { "command": "uvx", "args": [ "torrent-search-mcp" ] }, # with streamable-http transport (Docker compose: MCP on port 8001; standalone server: 8000) "torrent-search-mcp": { "serverUrl": "http://127.0.0.1:8001/mcp" }, # with sse transport (legacy; requires running server) "torrent-search-mcp": { "serverUrl": "http://127.0.0.1:8001/sse" }, ... } }