Synology MCP Server

Synology MCP Server is an MCP server that connects AI assistants directly to Synology NAS devices to manage storage and automated file operations. System administrators, homelab enthusiasts, and automated workflows use this integration to inspect and organize storage pools without relying exclusively on the Synology DSM web interface. The server provides structured Model Context Protocol tools for authenticating sessions, listing shared drives, inspecting directory contents, searching filenames recursively, and creating or moving files. It supports multiple transport protocols, including standard input/output (stdio) for local desktop tools, WebSocket bridges for platforms like Xiaozhi, and native Streamable HTTP through Uvicorn for remote deployments behind reverse proxies. By abstracting the Synology File Station APIs into standard MCP tool calls, users can prompt their AI clients to run background file management tasks, locate nested documents, create required folder structures, or handle routine cleanup across network shares while maintaining session security.

Category: Cloud & Infrastructure

Tags: download-station, file-management, nas, storage, synology

Visit Synology MCP Server

How to install and configure Synology MCP Server

1. Clone the repository and configure environment variables: bash git clone https://github.com/atom2ueki/mcp-server-synology.git cd mcp-server-synology cp env.example .env 2. Edit .env with your SYNOLOGY_URL, SYNOLOGY_USERNAME, and SYNOLOGY_PASSWORD. 3. Add the server to your Claude Desktop configuration (claude_desktop_config.json) using Docker Compose: json { "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" } } } 4. Alternatively, deploy the Streamable HTTP service via docker-compose.http.yml and connect via URL.

What you can do with Synology MCP Server

• Searching network shared drives recursively for specific documents, reports, or invoices matching case-insensitive string patterns. - Creating directory structures and saving generated text or structured logs directly to NAS shared folders from an AI prompt. - Moving, renaming, or pruning outdated files and empty directories across NAS storage without logging into the DSM web portal. - Inspecting NAS storage health, session authentication states, and browsing file metadata across mounted shared volumes.

Key facts

• https://github.com/atom2ueki/mcp-server-synology
• Cloud & Infrastructure, Files, Documents & PDFs
• download-station, file-management, nas, storage, synology

Part of MCP Servers

How do I install Synology MCP Server?

You can deploy the server by cloning the GitHub repository, copying env.example to .env to add your NAS credentials, and running it using Docker Compose. Alternatively, you can run it locally with Python by executing pip install . followed by python main.py.

What can Synology MCP Server do?

It provides tools to manage Synology NAS systems. Capabilities include checking session status, listing NAS shares, exploring directories, fetching file metadata, recursively searching for files by pattern, creating new files with content, making directories, renaming files, moving assets, and deleting files or directories.

Which MCP clients work with Synology MCP Server?

The server works with any MCP-compliant client. It includes documented setup examples for Claude Desktop, Cursor, Continue for VS Code, Codeium, and the Xiaozhi platform. It supports stdio, WebSocket, and native Streamable HTTP configurations.

Can I use Synology MCP Server remotely?

Yes. Setting MCP_HTTP=true enables a native Streamable HTTP server via Uvicorn on port 8765. You can place this behind a TLS-terminating reverse proxy, such as DSM Reverse Proxy or Nginx, allowing remote MCP clients to connect over HTTPS.