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.
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 | |
|---|---|---|---|
| stb_mcp_server-0.1.1.tar.gz | 6.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| stb_mcp_server-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
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
|