asustor-adm-mcp
Provides read-only Docker state inspection on the NAS: lists containers, Compose projects, images, and networks; inspects container metadata (returning only environment variable names); and retrieves container logs with common secret patterns masked.
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-adm-mcp
Read-only MCP server for Asustor NAS (ADM 5.x). It lets an assistant (Claude Desktop, Claude Code, Cursor…) query the NAS state without you having to paste command output by hand.
Tested on an AS5402T running ADM 5.1.4. Built for ADM: it does not use lsblk, smartctl or any Synology API; it reads /proc, /sys, /etc/nas.conf and the Docker API.
Tools (12, all read-only)
Tool | What it returns |
| Model and ADM version, kernel, CPU, load, uptime, RAM and swap |
| Physical disks ( |
| Usage of the paths configured in |
| Arrays from |
| Names and metadata inside |
| Docker state. |
Naming convention: list_* for collections, get_* for a single report, inspect_* for one object, search_* for searches.
Related MCP server: mcp-openmediavault
Giving the assistant context
The data the MCP returns does not explain your architecture, and a model tends to fill in the gaps (for example, suggesting loose data disks be used to rebuild a RAID). Describe your NAS in NAS_NOTES: it is delivered to the client as the server instructions. The MCP is read-only, but you should always double-check the model's suggestions before acting on them.
Security
No writes. There are no tools that stop, start or delete anything.
Isolated Docker socket. Only the
docker-socket-proxycontainer mounts it, withPOST=0; the MCP talks to it over HTTP on aninternalnetwork.Mandatory authentication. Bearer token (≥ 24 characters); the server will not start without it. Only
/healthis public.Confined paths.
realpathagainstFILE_ROOTS: no escaping with..or symlinks. Hidden by default:#Recycle,@eaDir,@tmpand anything starting with.,@or#.Hardened container. Non-root user, read-only filesystem,
cap_drop: ALL,no-new-privileges.What NOT to mount. Do not expose
/volume1/Dockeror folders containing.envfiles, databases or keys. An empty folder is used to measurevolume1.Do not publish it to the internet. Use it on the LAN or over a VPN (Tailscale, WireGuard). If you put it behind a reverse proxy, keep the token.
Deployment
git clone https://github.com/varossoft/asustor-adm-mcp.git mcp-nas && cd mcp-nas
cp .env.example .env # edit MCP_TOKEN (openssl rand -hex 32) and paths
mkdir -p /volume1/Docker/mcp-nas/vol1
docker compose up -d --buildIn .env, set MCP_BIND_IP to the NAS LAN (or Tailscale) IP: by default it only listens on 127.0.0.1.
The compose file attaches the MCP to an external Docker network called proxy (useful if you publish it through a reverse proxy); if you do not have one, remove it from the compose file or create it with docker network create proxy.
Endpoint: http://<host>:8088/mcp (streamable HTTP) with the header Authorization: Bearer <MCP_TOKEN>.
Example for Claude Code:
claude mcp add --transport http nas http://<NAS-IP>:8088/mcp --header "Authorization: Bearer $MCP_TOKEN"Configuration
Variable | Default | Description |
| — (required) | Bearer token |
| empty | Paths that can be listed/searched |
| empty |
|
| empty |
|
| empty | Free text the server sends to the client as instructions: describe your architecture (what each volume is, which disks are not RAID...) so the assistant does not assume it. Single line; use |
|
| Host IP on which port 8088 is published (LAN or Tailscale). Do not use |
|
| Arrays that raise an alert when degraded. On ADM, |
|
| Hidden folders |
|
| Character limit returned by |
|
| Server listen address |
Development
python -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt pytest
pytestThe tests include real /proc/mdstat output from a degraded RAID1 volume.
Changelog
0.3.0
Breaking: tools renamed to a consistent
verb_nounscheme:get_system_overview→get_system_info,get_disks→list_disks,list_files→list_directory,docker_ps→list_containers,docker_projects→list_compose_projects,docker_inspect→inspect_container,docker_logs→get_container_logs,docker_images→list_images,docker_networks→list_networks. The server name is nowasustor-adm-mcp.list_disksreports the mount points and md arrays of each disk, read from/proc/mountsand/proc/mdstat, so the assistant no longer depends onNAS_NOTESfor that.get_storage_usagereports the backingdeviceandfstype.
Roadmap
SMART: deliberately ruled out for now. Reading it from a container requires elevated capabilities (
SYS_ADMINfor NVMe,SYS_RAWIOfor SATA) and device access, too much privilege for a read-only service. Temperature is read without privileges.Btrfs volume status.
License
MIT.
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 server insight: why a Linux server or K8s cluster is slow, failing or changed.
Read-only MCP access to a documented IT fleet: state, changes, posture. 15 tools.
Read-only tools: App Store customer reviews and Docker Hub repo metadata.
Infrastructure context for any AI: VMware, Nutanix, Kubernetes and cloud. Read-only, off production.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides read-only server monitoring and diagnostic tools for AI assistants to manage Linux and Unraid systems via SSH. It enables natural language interactions for container management, storage health checks, and system log analysis while keeping credentials secure.17ISC
- FlicenseBqualityCmaintenanceEnables AI assistants to monitor and manage OpenMediaVault NAS systems by providing access to storage, network shares, user accounts, and system services. It supports OMV 5 and 6 via the JSON-RPC API for comprehensive hardware and configuration oversight through natural language.393-
- AlicenseAqualityDmaintenanceEnables AI assistants to read-only monitor iStoreOS/OpenWRT routers via SSH or HTTP/ubus API, providing 31 tools for system status, network info, logs, and plugin status (OpenClash, Passwall, AdGuardHome, etc.).31MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to inspect and operate a UGOS Pro NAS through its built-in HTTPS API via 25 tools covering system stats, storage volumes, files, downloads, photos, and media libraries, without SSH. Read-only tools run directly, write tools prompt for confirmation, destructive deletes require an explicit second confirmation, and it can be deployed either locally over stdio or on the NAS via Docker SSE.2MIT