synology — MCP server for Synology DSM management and Docker operations
draft — generated, polish on first use.
Category: mcp Where it works: Claude Code / Telegram (Hermes) / both Source: ~/.mcp.json
What it is
MCP server exposing 22 tools for Synology DSM control, Docker container management, SSH access, and filesystem operations on a Synology NAS.
How to trigger it
- “check the NAS status”
- “list running containers”
- “show disk usage”
- “connect via SSH”
- “read the config file”
- Direct trigger: none (tool calls only)
How to use it
Operator requests an action in natural language; the model selects and calls the appropriate tool from the 22 available. Results return as tool output. Some tools require prior login or ssh_connect.
Practical examples
- You: “show me the storage info” → calls
storage_info→ returns volume/disk capacity and health. - You: “restart the plex container” → calls
docker_compose_actionwith restart on the plex service.
Tools
| tool | what it does | example |
|---|---|---|
| docker_compose_action | run compose up/down/restart on a service | restart plex |
| docker_inspect | show container metadata | inspect plex |
| docker_logs | fetch container logs | logs for plex |
| dsm_info | DSM version, model, uptime | get DSM status |
| list_containers | list Docker containers | show all containers |
| list_directory | list files in a path | list /volume1/docker |
| list_disks | list physical disks | show disk health |
| list_shares | list shared folders | list all shares |
| list_volumes | list storage volumes | show volumes |
| login | authenticate DSM session | login to DSM |
| logout | end DSM session | logout |
| read_text_file | read file contents | read config.json |
| search_files | search for files by name/pattern | find *.log |
| session_status | check current DSM session | is logged in? |
| ssh_connect | open SSH session | connect to NAS |
| ssh_disconnect | close SSH session | disconnect SSH |
| ssh_run | execute command over SSH | run df -h |
| ssh_status | check SSH connection state | SSH connected? |
| storage_info | volume and disk usage summary | storage overview |
| system_info | CPU, RAM, temperature | system health |
| utilization | CPU/memory/disk load | current load |
| write_text_file | write or append to file | update config |
Notes / limits
Requires valid DSM credentials for login-based tools. SSH tools need SSH enabled on the NAS. No automatic session refresh—re-login if token expires.