Advertise
MCP.so
Sign In

Synology MCP Server

@atom2ueki

Repository

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

atom2ueki

About Synology MCP Server

💾 Model Context Protocol (MCP) server for Synology NAS - Enables AI assistants (Claude, Cursor, Continue) to manage files, downloads, and system operations through secure API integration. Features Docker deployment, auto-authentication, and comprehensive file system tools.

#mcp#synology#mcp-server

Synology MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-synology": {
      "command": "python",
      "args": [
        "main.py"
      ]
    }
  }
}

Synology MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Synology MCP Server?

A Model Context Protocol (MCP) server for Synology NAS devices. It enables AI assistants like Claude and Cursor to manage files, downloads, and system health through secure authentication and session management. The unified server supports both Claude/Cursor (stdio) and Xiaozhi (WebSocket) simultaneously.

How to use Synology MCP Server?

Clone the repository, copy env.example to .env, and configure the Synology NAS URL, username, and password. Run with docker-compose up -d (or python main.py for local execution). Then add the server to your MCP client (Claude Desktop, Cursor, Continue, or Codeium) using the provided JSON configuration. For remote access, deploy with the HTTP/SSE image and front with a TLS-terminating reverse proxy.

Key features of Synology MCP Server

  • Unified server supports both stdio and WebSocket clients simultaneously
  • File system operations: list, search, create, delete, rename, move
  • Download Station management: create, pause, resume, delete tasks
  • Health monitoring: system info, utilization, disk health, volumes, network, UPS
  • Container Manager: list, get, start, stop containers

Use cases of Synology MCP Server

  • AI assistant to browse, upload, and organize files on a Synology NAS
  • Automate download tasks via Download Station using URLs or magnet links
  • Monitor NAS health (CPU, memory, disk SMART, UPS status) from a chat interface
  • Deploy a remote MCP endpoint so Claude/Cursor can access the NAS over the internet

Frequently asked questions

1

What dependencies are required to run the server?

Docker is the primary method; alternatively, Python 3 with the packages in `requirements.txt`. The HTTP/SSE deployment also installs `mcp-proxy`.

2

How do I make the server accessible remotely?

Use the provided `docker-compose.http.yml` file to expose the MCP server over HTTP/SSE on port 8765, then front it with a reverse proxy (DSM Login Portal, Nginx, etc.) for TLS termination and optional authentication.

3

Does the server support multiple client protocols simultaneously?

Yes. When `ENABLE_XIAOZHI=true` is set in `.env`, the server acts as a bridge serving both stdio (for Claude/Cursor) and WebSocket (for Xiaozhi) at the same time.

4

What authentication is used?

The server authenticates with the Synology NAS using the credentials stored in the `.env` file (`SYNOLOGY_USERNAME`, `SYNOLOGY_PASSWORD`). The HTTP/SSE endpoint itself has no built-in authentication; it should be secured at the reverse proxy level.

5

Can I use this server with Continue (VS Code extension)?

Yes. Add the same Docker (or Python) configuration as for Claude/Cursor to your `./continue/config.json` `mcpServers` block.

Comments

More Developer Tools MCP servers

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

3

MCP Server By TestMu AI

TestMu AI

TestMu AI MCP Server lets developers run, debug, and triage tests through natural language directly from their IDE (Cursor, Claude, GitHub Copilot, and other MCP clients). It exposes five tools — HyperExecute (test orche

Modelglass

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

1

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

1

Eased

easedui

Eased is a library of motion-first React components for shadcn, installed with the shadcn CLI.

Advertise