philogicae/torrent-search-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

43 stars 9 forks 品質 82 トレンド 26MIT

Repository Install

MCP/API/WebUI は、プログラム的にトレントを見つける

概要

このリポジトリは、Python API/WebUI と MCP (Model Context Protocol) サーバを提供し、 , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , 他のアプリケーションやサービスに簡単に統合できます。共通のDNSの問題を回避するためにDockerで実行する - , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , - 代替HTTPアクセスのためのAPIサーバーインターフェイス(例、直接API呼び出しまたはテスト用)。 - 端末から直接クイックワンオフ検索のためのCLIモード。 - web UI デリバリーで 2 分間キャッシュされた common torrents; 検索はキャッシュされることはありません(同時同時リクエストのみが強制されます)ので、新しい結果はすぐに表示されます。 - In-memory 1-hour、再研磨なしでget torrentを介して磁石リンクを解決するためにのみ使用される5000-entryトレントキャッシュ。 - マグネットリンクは常に内部に保存されます。MCP は、INCLUDE LINKS=true を使わずに非表示にします。 - 環境変数を介してフィルタリング可能なソースを設定します.

概要（AI 翻訳）

このリポジトリは、Python API/WebUI と MCP (Model Context Protocol) サーバーで、ThePirateBay、1337x、Nyaa、YTS、EZTV、FitGirl、SubsPlease、UIndex のトレントを見つけます。他のアプリケーションやサービスに簡単に統合できます。

クイックスタート

MCPクライアントの使い方

一般的なDNSの問題を回避するためにDockerで実行する

コマンドラインから直接検索

コンテンツの表

特徴
サポートされているソース
セットアップ
前提条件
構成
インストール
PyPIからインストール(推奨)
ローカル開発のため
ドッカーのため
使用法
クリップとして
Python Wrapper として
MCP サーバーとして
API サーバーとして
MCP クライアントによる
Devinを使った例
変更ログ
貢献
ライセンス

##特徴

ThePirateBay, 1337x, Nyaa, YTS, EZTV, FitGirl, SubsPlease, **
MCP サーバーインターフェイス (FastMCP 4) 2026-07-28]]] プロトコルリビジョン [stdio]] または HTTP (http])) を、古いハンドシェイクリビジョンとレガシートランスファーエイリアス ([[streamable-http]]]) の自動交渉で実行します。
代替HTTPアクセス用のAPIサーバーインターフェース(例).

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

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

Features
Supported Sources
Setup
Usage
Changelog
Contributing
License

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).

GitHub で README 全文を見る

インストール

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"
    },
    ...
  }
}