SynoLink MCP Server

What is SynoLink MCP Server?

A Node.js server implementing the Model Context Protocol (MCP) for Synology NAS file operations. It allows you to interact with your Synology NAS device through Claude or other compatible AI assistants.

How to use SynoLink MCP Server?

Install dependencies (npm install), build the project (npm run build), then configure Claude Desktop by adding a config entry to claude_desktop_config.json. You can run the server with Node.js (pointing to dist/index.js) or via Docker (after building the image). The server requires your Synology NAS URL, username, and password as command-line arguments.

Key features of SynoLink MCP Server

• Login/logout authentication with Synology DSM
• List, download, upload, and delete files and folders
• Create, move, and rename files and folders
• Search for files and folders across your NAS
• Create and list sharing links for files or folders
• Retrieve server information and quota details

Use cases of SynoLink MCP Server

• Automate file management tasks on your Synology NAS via an AI assistant
• Upload or download files during AI-assisted workflows
• Search and organize NAS files from a chat interface
• Create share links for quick file sharing without manual DSM login
• Monitor NAS storage quota and server status

FAQ from SynoLink MCP Server

What prerequisites are needed?

Node.js 18 or higher, npm or yarn, a Synology NAS with DSM 6.0 or higher, and network access to your NAS.

How do I install and configure SynoLink MCP Server with Claude Desktop?

Clone the repository, run npm install and npm run build, then add a JSON block to your claude_desktop_config.json specifying either a Node.js command or a Docker run command with your NAS URL, username, and password.

What file operations does SynoLink MCP Server support?

It supports listing, downloading, uploading, creating folders, deleting, moving/renaming files and folders, searching, creating/list share links, and retrieving server and quota information.

How are credentials handled?

The current implementation sends the password as a command-line argument, which may be visible in process listings. For production, consider implementing alternative authentication methods.

Does SynoLink MCP Server support Docker?

Yes. You can build a Docker image using the provided Dockerfile and run the server as a Docker container with your Synology credentials.