mcp-server-synology

Overview

This is a comprehensive MCP server that enables Claude, Cursor, Continue, and other AI assistants to interact with Synology NAS devices. It provides secure authentication and session management, with Docker deployment options for easy setup. The server exposes numerous tools for file system operations, download station management, system health monitoring, and NFS configuration. A unique feature is its unified architecture supporting both stdio-based clients (Claude/Cursor) and WebSocket-based clients (Xiaozhi) simultaneously.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• synology_status

  Check authentication status and active sessions

  Try:Check if I'm authenticated to the Synology NASTry:What's the current session status?
• list_shares

  List all available NAS shares

  Try:Show me all the shared folders on my NASTry:What shares are available?
• list_directorypath: string (required)

  List directory contents with metadata

  Try:List the contents of /volume1/documentsTry:What files are in the photos directory?
• create_filepath: string (required), content?: string, overwrite?: boolean

  Create new files with content

  Try:Create a new file at /volume1/notes.txt with content 'Meeting notes'Try:Make a new config file with default settings
• ds_list_tasksoffset?: number, limit?: number

  List all download tasks with status

  Try:Show me all current download tasksTry:What downloads are currently active?
• ds_create_taskuri: string (required), destination?: string

  Create new download task

  Try:Download this file: https://example.com/largefile.zipTry:Add a torrent to download station
• synology_system_info

  Get system model, serial, DSM version, uptime, temperature

  Try:Show me my NAS system informationTry:What's the model and serial number of my Synology?
• synology_disk_health

  List all physical disks with SMART status, model, temp, size

  Try:Check the health status of all my disksTry:Are any drives showing SMART errors?
• synology_volume_status

  List all volumes with status, size, usage, filesystem type

  Try:Show me the status and usage of all volumesTry:How much free space do I have on each volume?
• search_filespath: string (required), pattern: string (required)

  Search files matching pattern

  Try:Find all PDF files in the documents folderTry:Search for any files named 'report' in the share
• synology_health_summary

  Aggregate system info, utilization, disk health, and volume status

  Try:Give me a complete health summary of my NASTry:What's the overall status of my system?
• synology_nfs_status

  Get NFS service status and configuration

  Try:Check the status of the NFS serviceTry:Is NFS enabled on my NAS?

Comparable tools

Installation

git clone https://github.com/atom2ueki/mcp-server-synology.git
cd mcp-server-synology

cp env.example .env

SYNOLOGY_URL=http://192.168.1.100:5000
SYNOLOGY_USERNAME=your_username
SYNOLOGY_PASSWORD=your_password
AUTO_LOGIN=true
VERIFY_SSL=false

docker-compose up -d

{
  "mcpServers": {
    "synology": {
      "command": "docker-compose",
      "args": [
        "-f", "/path/to/your/mcp-server-synology/docker-compose.yml",
        "run", "--rm", "synology-mcp"
      ],
      "cwd": "/path/to/your/mcp-server-synology"
    }
  }
}

FAQ

Can I use this with multiple Synology NAS devices?

Yes, the server supports multi-NAS setups through a settings.json file following the XDG Base Directory Specification.

Does this work with 2FA enabled accounts?

No, you need to create a dedicated account without 2FA as the MCP server cannot handle 2FA prompts.

Compare mcp-server-synology with