adm mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ASUSTOR NAS CLI
Safety-first Python CLI for ASUSTOR ADM NAS diagnostics, disk topology, DeadBolt ransomware checks, and guarded platform-driver module management. The command is named adm, after ASUSTOR's operating system.
繁體中文 · Command specification · Compatibility notes · Troubleshooting · Security · Research and licenses
What it does
Runs fixed, read-only SSH commands for ADM system, storage, RAID, network, and disk observations.
Reads SMART health status without starting self-tests; standby drives are left unqueried.
Reads available Linux thermal-zone temperatures as observations, without applying model-specific health thresholds.
Maps physical disks, partitions, Linux software RAID arrays, and
/volumeNmounts through/sysand/proc.Audits a DeadBolt prevention baseline, scans a bounded set of filenames and ADM portal text for known indicators, and compares saved JSON reports.
Checks whether the host meets the kernel and hardware requirements for
asustor-platform-driver; on supported Linux hosts, it can load or unload that driver family after creating a local state backup and completing explicit confirmation.Offers a dependency-free, read-only MCP server over stdio.
This project is an operations aid. It does not read file contents for malware, verify backup integrity, determine whether services are exposed through a router, or prove that a NAS is clean.
Related MCP server: qbittorrent-readonly-mcp
Install
Requirements: Python 3.10 or newer and the operating system's OpenSSH client. Runtime code uses only the Python standard library.
python -m pip install .
adm --helpFor isolated installs, use pipx install asustor-nas-cli after the package is published. Windows PowerShell and offline wheel instructions are in publishing and installation.
For local development without installing:
$env:PYTHONPATH = '.\src'
python -m asustor_nas_cli --helpQuick start
$env:ASUSTOR_HOST = 'nas.example'
$env:ASUSTOR_USER = 'nas-user'
adm probe --insecure --json
adm health --json
adm disk-topology --jsonSSH normally uses port 22; ADM HTTPS uses port 8001. Set ASUSTOR_SSH_PORT or ASUSTOR_HTTPS_PORT, or pass --port / --https-port. For key authentication, set ASUSTOR_SSH_IDENTITY_FILE or pass --identity-file. The CLI does not store SSH passwords. Password login requires an interactive terminal; MCP uses OpenSSH batch mode and therefore needs a working key or agent.
The sample NAS has a self-signed HTTPS certificate. --insecure skips certificate verification for that request and the report records the unverified state. Prefer a trusted certificate or --ca FILE.pem for routine use. --ca and --insecure cannot be combined.
Privacy defaults
CLI JSON and MCP responses label the device as NAS and include a stable host_id fingerprint for report comparison; they do not emit the configured host address. IP/MAC addresses in SSH output and NAS account names in error text are redacted. The client never accepts, displays, or stores a NAS password or private-key content. Treat incident file paths and DMI model identifiers as operational data when sharing reports.
Commands
Command | Purpose |
| Check the ADM HTTPS portal and certificate |
| Probe HTTPS and collect SSH diagnostics |
| Read ADM and Linux observations |
| Map disks, partitions, md arrays, and volumes |
| Read SMART health status without starting self-tests |
| Read available thermal-zone temperatures; no health thresholds are applied |
| Review the DeadBolt prevention baseline |
| Search volume filenames and portal text for bounded DeadBolt indicators |
| Compare two compatible audit or scan JSON reports |
| Read kernel, DMI, and platform-driver module state |
| Guarded module lifecycle control on verified compatible Linux hosts |
| Serve read-only MCP tools over stdio |
All NAS observation commands support --json. JSON reports use schema_version: 1; supported report schemas are in schemas/. Command exit codes are documented in the CLI specification.
adm smart runs only smartctl -H -n standby for supported block-device names. It does not start SMART self-tests or include disk serials/attributes; sleeping drives may be reported as unknown. This command has parser fixtures and schema coverage, but has not yet been exercised live on the AS-202TE.
adm temperature reads /sys/class/thermal/thermal_zone*/temp, a read-only Linux thermal-zone interface whose values are reported in millidegrees Celsius. It exposes only generic zone IDs and Celsius values. Sensor coverage varies by model and kernel; no temperature thresholds or health verdicts are inferred. The command has parser fixtures and schema coverage, but has not yet been exercised live on the AS-202TE.
DeadBolt prevention and detection
adm security audit checks the ADM version against the referenced ASUSTOR DeadBolt advisory, inspects the local TCP listener list, and looks for limited DeadBolt-related strings in the ADM portal. Backup readiness, password strength, EZ-Connect, and router exposure remain unknown until an operator confirms them; confirmation flags record operator assertions, not automatic verification.
adm incident scan searches filenames ending in .deadbolt on /volumeN mounts and checks limited portal text. It does not inspect file contents, quarantine or delete files, or stop services. The search has configurable limits (--max-seconds and --max-hits). It discovers find, timeout, and awk through PATH and checks find -xdev support before starting; if a required bounded-scan capability is missing, the report marks file coverage unavailable. An incomplete scan stays incomplete, and a missing indicator is not proof that the NAS is uninfected.
adm security audit --host nas.example --user nas-user --insecure --json > audit-before.json
adm incident scan --host nas.example --user nas-user --insecure --json > scan-before.json
# Save later reports, then compare like with like:
adm security compare --before scan-before.json --after scan-after.jsonThe checks are based on ASUSTOR's DeadBolt advisory, ADM release notes, and prevention guidance. The current rule set is intentionally narrow and versioned as asustor-deadbolt-v1.
Platform-driver module controls
The platform driver can expose GPIO-backed LEDs and buttons; its optional IT87 module can expose fan PWM controls. Incorrect GPIO mappings can destabilize a system or damage hardware. This CLI therefore checks the running kernel and exact DMI vendor/product pair before permitting a module operation. The driver project documents Linux 6.1 and newer as its supported kernel floor, and its compatibility list does not include AS-202TE. The AS-202TE test unit runs Linux 3.4, so this CLI reports it as unsupported and refuses module changes.
Module changes are disabled unless all these conditions hold:
The NAS reports Linux 6.1 or newer.
Its DMI vendor/product pair is in the verified allowlist documented in compatibility.
The conflicting
it87module is not loaded when the operation needsasustor_it87.The operator supplies
--confirm-riskand a local backup path.modprobe -nresolves the fixed module plan without changing module state.The normal path also requires typing the exact action and masked NAS fingerprint at a prompt.
Example load and rollback:
adm platform status --host NAS-IP --user nas-user
adm platform module --load --host NAS-IP --user nas-user \
--backup ./platform-before.json --confirm-risk
adm platform module --reset --host NAS-IP --user nas-user \
--backup ./platform-before.json --confirm-riskBefore loading or unloading, the CLI writes a non-overwriting local JSON backup of the three managed modules' loaded/unloaded state. --reset restores that state only when host, kernel release, and DMI identity still match. Before reset, it also creates a snapshot of the current state at <backup>.before-reset.json (customize with --rollback-backup) so a later reset can reverse that operation. The backup does not include module binaries, NAS data, firmware settings, LED brightness, or fan PWM values; reset is a best-effort module-state restore, not a full system rollback. The CLI does not install/build kernel modules or write LED/fan sysfs values.
Advanced automation may add --force to skip the interactive second confirmation. It still requires --confirm-risk, a valid backup (or existing matching backup for --reset), and all compatibility checks. --force never maps to the kernel's forced module-unload option.
Read-only MCP server
Configure your MCP client to launch adm mcp and provide its environment:
{
"mcpServers": {
"asustor": {
"command": "adm",
"args": ["mcp"],
"env": {
"ASUSTOR_HOST": "nas.example",
"ASUSTOR_USER": "nas-user",
"ASUSTOR_SSH_IDENTITY_FILE": "/path/to/id_ed25519",
"ASUSTOR_HTTPS_PORT": "8001"
}
}
}
}The server requires SSH key/agent authentication, uses fixed SSH commands, and exposes read-only tools only. It includes SMART and temperature observations plus adm_security_compare, which compares two report objects without connecting to the NAS. adm_platform_status is read-only; module load, unload, and reset are not available over MCP. See MCP and JSON interface details.
Project design and contribution
The CLI follows the product conventions of synology-nas-cli and qnap-nas-cli: OS-named command, structured reports, MCP, explicit safety boundaries, compatibility notes, and reusable docs. The reference review explains what was adopted and what was excluded from the three ASUSTOR projects.
See architecture, troubleshooting, release checklist, security review, contributing, publishing and installation, change log, and security policy.
License and trademarks
This project's original code and documentation are licensed under MIT; see LICENSE. Research sources and the license review are recorded in Research and licenses, with design decisions in the reference review.
This is an independent community project. It is not affiliated with, endorsed by, or sponsored by ASUSTOR Inc. ASUSTOR, ADM, and ASUSTOR product and model names are trademarks of their respective rights holders.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only agent-commerce audit, upgrade verification, diagnosis and x402 probing.
Read-only server insight: why a Linux server or K8s cluster is slow, failing or changed.
Read-only local AI advice, shared reports and website audits. No PC scan or local actions.
Read-only tools over the Psychopathia Machinalis nosology: 79 conditions, 11 tools.
Related MCP Servers
- AlicenseAqualityFmaintenanceEnables read-only Linux system diagnostics and troubleshooting on RHEL-based systems, including system info, services, processes, logs, network, and storage analysis. Supports both local and remote SSH execution across multiple hosts.20MIT
- AlicenseAqualityDmaintenanceProvides read-only MCP tools for qBittorrent diagnostics, enabling health checks, torrent listing, detail retrieval, and problem analysis via local stdio without any write operations.5MIT
- AlicenseBqualityCmaintenanceEnables stdio MCP clients to gather read-only diagnostics and incident evidence from Linux homelabs, including health, disks, services, Docker containers, logs, and confirmation-required remediation proposals.10MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to query QNAP QTS NAS status, health, storage, network, and Tailscale diagnostics through five read-only stdio tools, with no general shell or arbitrary API access.3MIT