https://github.com/andrey-oss/mc-checker
MC-Checker - Minecraft server checker written on python3
https://github.com/andrey-oss/mc-checker
api minecraft parser python3 server
Last synced: 3 months ago
JSON representation
MC-Checker - Minecraft server checker written on python3
- Host: GitHub
- URL: https://github.com/andrey-oss/mc-checker
- Owner: Andrey-oss
- License: mit
- Created: 2021-08-22T10:41:16.000Z (almost 5 years ago)
- Default Branch: v1.0-beta
- Last Pushed: 2025-07-03T12:48:38.000Z (12 months ago)
- Last Synced: 2025-07-03T13:47:02.851Z (12 months ago)
- Topics: api, minecraft, parser, python3, server
- Language: Python
- Homepage:
- Size: 1000 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
README
# MC-Checker v1.0-beta
A simple Minecraft server status checker built using Python and the [mcsrvstat.us](https://api.mcsrvstat.us/) API.
---
## Features
- Checks online status of **Minecraft Java** and **Bedrock** servers (WIP)
- Displays key server info (players, MOTD, version, etc.)
- Lightweight and fast
- CLI-based with ASCII logo
- Modular codebase (`core/` package)
---
## Requirements
- Python 3.7+
- Internet connection
## Install required packages with:
```bash
pip install requests
```
## How to Run
```bash
python3 mc-checker.py
```
Then enter the target Minecraft server address when prompted:
```
Target server: hypixel.net
```
## Project Structure
```
MC-Checker/
├── mc-checker.py # Main entry point
├── core/
│ ├── logo.py # ASCII logo printer
│ ├── main.py # Server info parser and printer
│ ├── probe_request.py # Initial API probe request
│ └── server_checker.py # Service checker
├── LICENSE
├── README.md
└── CHANGELOG
```
## API Reference
* Java: https://api.mcsrvstat.us/2/
* Bedrock: https://api.mcsrvstat.us/bedrock/2/
## License
This project is licensed under the MIT License. See LICENSE for details.