Metadata-Version: 2.4
Name: stb-mcp-server
Version: 0.1.1
Summary: MCP Server untuk kontrol penuh server STB (Armbian/Amlogic) via SSH + CasaOS
Project-URL: Homepage, https://github.com/lightnet19/stb-mcp-server
Project-URL: Repository, https://github.com/lightnet19/stb-mcp-server
Author-email: Fuad Al Fajri <achmadalfajri@gmail.com>
License: MIT
License-File: LICENSE
Keywords: adguard,armbian,casaos,mcp,ssh,stb
Requires-Python: >=3.10
Requires-Dist: fastmcp>=3.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: paramiko>=3.0.0
Description-Content-Type: text/markdown

# 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](https://hermes-agent.nousresearch.com) oleh [Fuad Al Fajri](https://github.com/lightnet19).

## 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

```bash
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](https://github.com/lightnet19/stb-mcp-server)
- **Lisensi**: MIT

## Kontribusi

Silakan lihat [CONTRIBUTING.md](CONTRIBUTING.md) untuk panduan kontribusi.
