mcp-server-synology

mcp-server-synology

3.4

If you are the rightful owner of mcp-server-synology and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server for Synology NAS devices, enabling AI assistants to manage files and downloads through secure authentication and session management.

The Synology MCP Server is a versatile tool designed to integrate AI assistants with Synology NAS devices, allowing for efficient file and download management. It supports both Claude/Cursor (stdio) and Xiaozhi (WebSocket) clients simultaneously, providing a unified server architecture. The server facilitates secure authentication and session management, ensuring that user data is protected while enabling seamless operations. With Docker support, the server can be easily deployed in a containerized environment, making it accessible for both novice and advanced users. The server's architecture is designed to handle multiple clients without configuration conflicts, allowing for parallel operations and access to all Synology MCP tools. This makes it an ideal solution for users looking to enhance their NAS device's capabilities with AI-driven automation and management.

Features

  • Unified Entry Point - Single main.py supports both stdio and WebSocket clients.
  • Environment Controlled - Switch modes via ENABLE_XIAOZHI environment variable.
  • Multi-Client Support - Simultaneous Claude/Cursor + Xiaozhi access.
  • Secure Authentication - RSA encrypted password transmission.
  • Complete File Operations - Create, delete, list, search, rename, move files with detailed metadata.

Tools

  1. synology_status

    Check authentication status and active sessions

  2. synology_login

    Authenticate with Synology NAS (conditional)

  3. synology_logout

    Logout from session (conditional)

  4. list_shares

    List all available NAS shares

  5. list_directory

    List directory contents with metadata

  6. get_file_info

    Get detailed file/directory information

  7. search_files

    Search files matching pattern

  8. create_file

    Create new files with content

  9. create_directory

    Create new directories

  10. delete

    Delete files or directories (auto-detects type)

  11. rename_file

    Rename files or directories

  12. move_file

    Move files to new location

  13. ds_get_info

    Get Download Station information

  14. ds_list_tasks

    List all download tasks with status

  15. ds_create_task

    Create new download task

  16. ds_pause_tasks

    Pause download tasks

  17. ds_resume_tasks

    Resume paused tasks

  18. ds_delete_tasks

    Delete download tasks

  19. ds_get_statistics

    Get download/upload statistics