Tools Repository

A collection of utility scripts, MCP servers, and random tools for various automation tasks.

Repository Structure

.
├── tools/
│   ├── downloaders/      # Media download scripts (YouTube, podcasts, etc.)
│   └── ...               # Other utility scripts
├── mcp-servers/          # Model Context Protocol servers
└── .venv/                # Python virtual environment

Available Tools

Downloaders

Python scripts for downloading media from various sources including YouTube, podcasts, RSS feeds, and Spotify.

See tools/downloaders/README.md for detailed documentation.

Quick start:

cd tools/downloaders
python main.py

MCP Servers

Coming soon. MCP servers will be placed in the mcp-servers/ directory.

Installation

Each tool directory contains its own requirements. For the downloaders:

cd tools/downloaders
pip install yt-dlp feedparser requests

Contributing

When adding new tools:

1. Place utility scripts and tools in tools/ subdirectories
2. Place MCP servers in mcp-servers/
3. Include a README.md with usage instructions
4. Add dependencies to requirements.txt or document installation steps
5. Update this root README with a brief description

Development

This repository uses Python virtual environments. To set up:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt