Skip to main content
Glama

nas-mcp

An MCP server that lets Claude look after a Synology NAS: system health, disks and volumes, Docker containers (state, logs, diagnosis), Watchtower update history, backups, and the NAS gate security scan.

Stage 1a: read-only, home network only. Nothing here can change the NAS: Docker is reached through a socket proxy with POST disabled, and mounted folders are read-only.

Tools

Tool

What it answers

nas_overview

How is the NAS? (everything below, summarised)

nas_system

Model, DSM version, uptime, temperature, CPU, memory

nas_storage

Disks (SMART, temperature, bad sectors), pools, volumes

containers_list

Every container with state, image, project, ports

container_details

One container: exit code and meaning, restarts, mounts, last update

container_logs

The container's log, secrets redacted

container_diagnose

Problems and suggested fixes (see below)

watchtower_history

What Watchtower updated or stopped, and when

nas_timeline

Starts, stops, crashes, OOM kills, pulls and updates over time

backups_status

Newest file per backup target, late or not

security_scan / gate_status

From the NAS gate, if configured

folders_list, files_list, file_read, files_search

Allowed folders only

What container_diagnose finds

  • crash loops and errors that repeat in the log

  • containers stopped with no visible cause, matched against Watchtower's own log (Container Manager does not show what Watchtower does)

  • breakage that started right after a Watchtower update, with a rollback suggestion

  • permission errors (suggests user: "1026:100"), ports in use, missing bind folders, options a new version removed, wrong architecture, full disk, out of memory

  • no restart policy, standalone containers (suggests a Compose project), :latest tags

  • services without a password, privileged mode, unmaintained images

Docker forgets past events when it restarts, so a small recorder keeps its own log in data/events.jsonl for nas_timeline.

Related MCP server: MCP SSH SRE

Install (Container Manager)

  1. Create a DSM administrator user for the server (2-step verification off for it).

  2. Create the folder /volume1/docker/nas-mcp and inside it a folder data.

  3. Put docker-compose.yml in it, .env.example as .env, and config.example.yaml as data/config.yaml; fill them in.

  4. Container Manager → Project → Create → path /volume1/docker/nas-mcp.

  5. Open http://<nas>:8790/?token=<your token> for the status page.

Everything specific to one NAS lives in data/config.yaml and .env, never in this repository.

Roadmap

  • 1b: OAuth and a public address (Tailscale Funnel or Cloudflare Tunnel) for Claude

  • 1c: write tools behind an "MCP" window in the NAS gate, phone approval for destructive actions, nothing ever deleted (renamed _to_delete_…)

  • 1d: post-update checks with a one-tap rollback, NAS health scan

  • 2: media apps (Seerr, Radarr, Sonarr, Jellyfin)

Development

pip install -r requirements.txt pytest
python -m pytest -q

Related MCP Connectors

Related MCP Servers

  • F
    license
    A
    quality
    D
    maintenance
    Enables Claude to monitor and manage homelab infrastructure including Docker containers, OPNsense firewall, and TrueNAS storage with configurable capability levels from read-only monitoring to full management control.
    13
    58 npm
    7
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides 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.
    17
    ISC
  • A
    license
    A
    quality
    D
    maintenance
    Enables Claude to monitor CPU, memory, disk, processes, network connections, Docker containers, and system logs for system diagnostics and troubleshooting.
    5
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Provides Claude with read-only access to PC diagnostics including hardware specs, live performance metrics, disk usage, network checks, and more, enabling natural language queries about PC health and performance.
    15
    1
    MIT