Skip to main content
Glama
lightnet19
by lightnet19

STB MCP Server

mcp-name: io.github.lightnet19/stb-mcp-server

MCP Registry PyPI version

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

Related MCP server: hass-mcp-server

Instalasi

Prasyarat

  • Python 3.10+

  • SSH key dengan akses ke server target

  • cloudflared di PATH (untuk tunnel proxy)

pip install stb-mcp-server

Setup dari Source

git clone https://github.com/lightnet19/stb-mcp-server
cd stb-mcp-server
python3 -m venv venv
source venv/bin/activate
pip install -e .

# Register ke Hermes Agent
hermes mcp add stb --command "$(pwd)/run.sh"

Konfigurasi SSH

Server membaca environment variables saat start. Default aman untuk publik (placeholder) โ€” override per instance via env:

Variabel

Default

Keterangan

STB_HOST

sshstb.your-domain.example.com

Hostname/IP server target

STB_USER

root

User SSH

STB_KEY

~/.ssh/stb_alfajri

Path private key

STB_PROXY_HOST

nilai STB_HOST

Host untuk tunnel proxy (cloudflared access ssh); kosongkan jika koneksi langsung (OVPN/LAN)

Multi-Host (beberapa STB)

Satu codebase bisa melayani banyak STB sekaligus โ€” daftarkan instance MCP terpisah, masing-masing dengan wrapper + file env sendiri:

# .stb1.env (STB1 โ€” via Cloudflare Tunnel)
STB_HOST=stb1.your-domain.example.com
STB_USER=root
STB_KEY=/home/user/.ssh/stb1_key
STB_PROXY_HOST=stb1.your-domain.example.com
# .stb2.env (STB2 โ€” via OVPN/LAN, tanpa proxy)
STB_HOST=10.0.0.5
STB_USER=root
STB_KEY=/home/user/.ssh/stb2_key
STB_PROXY_HOST=
# run-stb2.sh (wrapper instance kedua)
#!/bin/bash
cd /path/to/stb-mcp-server
export PYTHONUNBUFFERED=1
set -a; source /path/to/stb-mcp-server/.stb2.env; set +a
exec /path/to/stb-mcp-server/venv/bin/python3 -m stb_mcp_server
# Register instance kedua ke Hermes Agent
hermes mcp add stb2 --command "/path/to/stb-mcp-server/run-stb2.sh"

โš ๏ธ File .env berisi kredensial โ€” sudah ada .env* di .gitignore, JANGAN pernah di-commit ke repo publik.

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.

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

โ€“Maintainers
โ€“Response time
โ€“Release cycle
โ€“Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    D
    maintenance
    An MCP server that gives AI assistants full SSH/SFTP remote operations โ€” session management, command execution, interactive shells, file transfers, port forwarding, and system diagnostics.
    2
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    MCP server for full Home Assistant control, enabling AI agents to manage dashboards, automations, files, apps, entities, and more via REST API, WebSocket, and SSH.
    66
    90
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    MCP server for SSH and local terminal access. Supports interactive commands, long-running processes, and TUI apps like tmux/zellij
    6
    3
    MIT
  • F
    license
    -
    quality
    D
    maintenance
    MCP server for managing Ubuntu servers with AI integration, enabling system monitoring, Docker control, Gitea repository management, Ollama LLM interaction, workspace file operations, and Claude Code assistant via natural language.

View all related MCP servers

Related MCP Connectors

  • MCP server for Gainium โ€” manage trading bots, deals, and balances via AI assistants

  • Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.

  • MCP server for interacting with the Supabase platform

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lightnet19/stb-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server