STB MCP Server
mcp-name: io.github.lightnet19/stb-mcp-server
MCP Server untuk kontrol penuh server STB (Amlogic S9xx / Armbian) — SSH via Cloudflare Tunnel + CasaOS + AdGuard Home.
Dibuat untuk Hermes Agent oleh Fuad Al Fajri.
Tools
| # | Tool | Fungsi |
|---|---|---|
| 1 | stb_execute |
🔧 Jalankan perintah shell |
| 2 | stb_read_file |
📄 Baca file |
| 3 | stb_write_file |
✏️ Tulis file |
| 4 | stb_system_info |
📊 Info sistem (OS, CPU, RAM, disk, uptime, suhu) |
| 5 | stb_docker_list |
🐳 Daftar container running |
| 6 | stb_docker_logs |
📋 Log container (tail N baris) |
| 7 | stb_docker_restart |
🔄 Restart container |
| 8 | stb_docker_stats |
📈 Resource CPU/RAM container |
| 9 | stb_adguard_config |
🛡️ Parameter utama AdGuard Home |
| 10 | stb_adguard_full_config |
📑 Full file YAML AdGuard |
| 11 | stb_adguard_stats |
📉 Statistik DNS AdGuard |
| 12 | stb_cleanup_root |
🧹 Bersihkan root filesystem |
| 13 | stb_casaos_status |
🏠 Status CasaOS |
Instalasi
Prasyarat
- Python 3.10+
- SSH key dengan akses ke server target
cloudflareddi PATH (untuk tunnel proxy)
Setup
git clone https://github.com/lightnet19/stb-mcp-server
cd stb-mcp-server
python3 -m venv venv
source venv/bin/activate
pip install fastmcp httpx paramiko
# Register ke Hermes Agent
hermes mcp add stb --command "$(pwd)/run.sh"
Konfigurasi SSH
Edit stb_mcp_server/server.py atau set environment:
| Variabel | Default | Keterangan |
|---|---|---|
SSH_HOST |
sshstb.alfajrihomelab.my.id |
Hostname SSH |
SSH_USER |
root |
User SSH |
SSH_KEY |
~/.ssh/stb_alfajri |
Path private key |
SSH_PROXY |
cloudflared access ssh --hostname %s |
Proxy command |
Cara Kerja
[Hermes Agent] → MCP stdio → [stb-mcp-server] → SSH → [Server STB]
Semua tool dieksekusi via SSH ke server target. SSH key + Cloudflare Tunnel digunakan untuk koneksi aman tanpa port terbuka.
Struktur Project
stb-mcp-server/
├── pyproject.toml # Package metadata
├── README.md # Dokumentasi
├── CONTRIBUTING.md # Panduan kontribusi
├── LICENSE # MIT License
├── run.sh # Wrapper script (Hermes entry point)
└── stb_mcp_server/
├── __init__.py
├── __main__.py # python3 -m entry point
└── server.py # Tools MCP (FastMCP)
Publikasi
- GitHub: lightnet19/stb-mcp-server
- Lisensi: MIT
Kontribusi
Silakan lihat CONTRIBUTING.md untuk panduan kontribusi.
Metadata
Release files for stb-mcp-server 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| stb_mcp_server-0.1.1.tar.gz | 6.6 kB | Without provenance | Details for stb_mcp_server-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| stb_mcp_server-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for stb_mcp_server-0.1.1-py3-none-any.whl |
Total release size: 13.4 kB
Release files / stb_mcp_server-0.1.1.tar.gz
| Download URL | stb_mcp_server-0.1.1.tar.gz |
|---|---|
| Size | 6.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8fa4487db1fc77f7e233a62c802354897045f1d486b6b88af241638c312072e0
|
|
BLAKE2b-256 checksum How to use checksums |
66fea400c4fc09e800ec8ee262962bc0d227c29f9a4aff89e36f14276a7e12ef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.15
|
Release files / stb_mcp_server-0.1.1-py3-none-any.whl
| Download URL | stb_mcp_server-0.1.1-py3-none-any.whl |
|---|---|
| Size | 6.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
460f6e20dae9762467b1f83eea1e98c7daf54bed5b6ed0231b004621b6f42c6d
|
|
BLAKE2b-256 checksum How to use checksums |
0829f4bd339eeea734f9f345c9e3a286eaa1227358eed3393fea768bd35964b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.15
|
Security for stb-mcp-server 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.