Skip to main content

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

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)

Source distribution for stb-mcp-server 0.1.1
File Size Uploaded
stb_mcp_server-0.1.1.tar.gz 6.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for stb-mcp-server 0.1.1
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page