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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stb_mcp_server-0.1.1.tar.gz (6.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

stb_mcp_server-0.1.1-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

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

Hashes for stb_mcp_server-0.1.1.tar.gz
Algorithm Hash digest
SHA256 8fa4487db1fc77f7e233a62c802354897045f1d486b6b88af241638c312072e0
MD5 afa1d87eefdc90d9642d34074673fd08
BLAKE2b-256 66fea400c4fc09e800ec8ee262962bc0d227c29f9a4aff89e36f14276a7e12ef

See more details on using hashes here.

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

Hashes for stb_mcp_server-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 460f6e20dae9762467b1f83eea1e98c7daf54bed5b6ed0231b004621b6f42c6d
MD5 96f41e5588d08bd147aade09ccdcd980
BLAKE2b-256 0829f4bd339eeea734f9f345c9e3a286eaa1227358eed3393fea768bd35964b4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page