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.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file stb_mcp_server-0.1.1.tar.gz.
File metadata
- Download URL: stb_mcp_server-0.1.1.tar.gz
- Upload date:
- Size: 6.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8fa4487db1fc77f7e233a62c802354897045f1d486b6b88af241638c312072e0
|
|
| MD5 |
afa1d87eefdc90d9642d34074673fd08
|
|
| BLAKE2b-256 |
66fea400c4fc09e800ec8ee262962bc0d227c29f9a4aff89e36f14276a7e12ef
|
File details
Details for the file stb_mcp_server-0.1.1-py3-none-any.whl.
File metadata
- Download URL: stb_mcp_server-0.1.1-py3-none-any.whl
- Upload date:
- Size: 6.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
460f6e20dae9762467b1f83eea1e98c7daf54bed5b6ed0231b004621b6f42c6d
|
|
| MD5 |
96f41e5588d08bd147aade09ccdcd980
|
|
| BLAKE2b-256 |
0829f4bd339eeea734f9f345c9e3a286eaa1227358eed3393fea768bd35964b4
|