Ayfri/MCUS

MCUS is a focused little utility with a clear job: watch a Minecraft username and alert the user when Mojang’s profile endpoint stops resolving it. I like that the project has moved beyond a loose script into a pyproject.toml setup with a mcus console entry point, uv.lock, and a GitHub Actions workflow that runs type checking on Windows. That fits the current shape of the tool well, since the strongest user path is Windows-oriented: execute.bat, winotify, desktop note creation, and Notepad launch all make the “I want to react immediately when a name frees up” workflow pretty direct.

The README is also practical. It explains both the batch-file path and the manual uv run mcus --username ... --interval ... path, and it documents Discord webhook support without making it required. The Apache-2.0 license is a good choice if you want people to reuse or adapt the tool.

The main thing I would improve is reliability around edge cases. The checker currently treats 204/404 as available and 200 as taken, but Minecraft usernames have validation rules, cooldown behavior, and potentially rate-limit or blocked-name cases that users may misread as “available.” Adding local username validation, clearer messaging for 429/5xx responses, and a short README note about Mojang cooldowns would make the tool more trustworthy. I’d also consider separating the pure availability check from side effects like Windows notifications, Notepad, and Discord posts so it can be tested without touching the user’s desktop. A few tests around HTTP status handling would raise confidence a lot, especially because this is a polling tool people may leave running for long periods.

Overall, MCUS is small but useful, and the packaging/CI work shows good care for setup. With input validation, test coverage, and slightly more platform-neutral notification handling, it would be easier for new users to trust and for contributors to extend.