stb-mcp-server

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
• cloudflared di 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.