YggTorrent MCP Server

YggTorrent MCP Server & Wrapper

This repository provides a Python wrapper for the YggTorrent website and an MCP (Model Context Protocol) server to interact with it programmatically. This allows for easy integration of YggTorrent functionalities into other applications or services.

Features

API wrapper for YggAPI, an unofficial API for YggTorrent.
Your Ygg passkey is injected locally into the torrent file/magnet link, ensuring it's not exposed externally.
MCP server interface for standardized communication.
Search for torrents on YggTorrent (MCP tool).
Get details for a specific torrent (MCP tool).
Retrieve magnet links (MCP tool).
Retrieve torrent files (wrapper only).
Retrieve torrent categories (MCP resource).

Setup

There are two primary ways to set up and run this project: using a local Python environment or using Docker.

Prerequisites

An active YggTorrent account with a passkey.
Python 3.10+ (for local Python setup)
pip (Python package installer, for local Python setup)
Docker and Docker Compose (for Docker setup)

Install from PyPI

pip install ygg-torrent-mcp

1. Local Python Environment Setup

Clone the repository:
git clone https://github.com/philogicae/ygg-torrent-mcp.git cd ygg-torrent-mcp
Create and activate a virtual environment (recommended):
python3 -m venv venv source venv/bin/activate # On Windows, use: venv\Scripts\activate
Install dependencies:
pip install -e .
Configure environment variables:Copy the .env.example file to .env and fill in the required variables (Ygg passkey).
Run the MCP Server:
python -m ygg_torrent
The MCP server will be accessible locally on port 8000.

2. Docker Setup

This project includes a Dockerfile and docker-compose.yaml for easy containerization.

Clone the repository (if you haven't already):
git clone https://github.com/philogicae/ygg-torrent-mcp.git cd ygg-torrent-mcp
Configure environment variables:Copy the .env.example file to .env and fill in the required variables (Ygg passkey).
Build and run the Docker container using Docker Compose:
docker-compose -f docker/compose.yaml up --build
This command will build the Docker image (if it doesn't exist) and start the service.
Accessing the server:The MCP server will be accessible on port 8765.

Usage

As Python Wrapper

from ygg_torrent import ygg_api

results = ygg_api.search_torrents('...')
for torrent in results:
    print(torrent.name, torrent.size, torrent.seeders)

As MCP Server

from ygg_torrent import ygg_mcp

ygg_mcp.run(transport="sse")

Via MCP Clients

Once the MCP server is running, you can interact with it using any MCP-compatible client. The server will expose endpoints for:

search_torrents: Search for torrents.
get_torrent_details: Get details of a specific torrent.
get_magnet_link: Get the magnet link for a torrent.

Example for Windsurf

{
  "mcpServers": {
    "mcp-ygg-torrent": {
      "serverUrl": "http://127.0.0.1:8000/sse"
    }
  }
}

Contributing

Contributions are welcome! Please feel free to submit a Pull Request or open an Issue.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Python MCP server that allows programmatic interaction with YggTorrent, enabling torrent search, details retrieval, and magnet link generation without exposing your Ygg passkey.

Related MCP Servers

Lodestar MCP Server
kanlanc
-
security
F
license
-
quality
This is an MCP server that facilitates building tools for interacting with various APIs and workflows, supporting Python-based development with potential for customizable prompts and user configurations.
Last updated -
Python
MD Webcrawl MCP
jmh108
-
security
A
license
-
quality
A Python-based MCP server that crawls websites to extract and save content as markdown files, with features for mapping website structure and links.
Last updated -
1
Python
MIT License
Python REPL MCP Server
hdresearch
A
security
A
license
A
quality
A server that provides a persistent Python REPL environment through the MCP protocol, allowing execution of Python code, variable management, and package installation.
Last updated -
3
3
Python
MIT License
MCP Builder
XD3an
-
security
F
license
-
quality
A Python-based server that helps users easily install and configure other MCP servers across different platforms.
Last updated -
2
Python

View all related MCP servers

YggTorrent MCP Server