Synology MCP Server

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

Local serverstdioPython

What is the Synology MCP server?

Synology mcp server connects Synology to AI assistants that speak the Model Context Protocol. A Model Context Protocol (MCP) server for Synology NAS devices. Enables AI assistants to manage files and downloads through secure authentication and session management.

What Synology does

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

Key capabilities

  • Zero Configuration Conflicts: One server, multiple clients
  • Parallel Operation: Both clients can work simultaneously
  • All Tools Available: Xiaozhi gets access to all Synology MCP tools
  • Backward Compatible: Existing setups work unchanged
  • Auto-Reconnection: Handles WebSocket connection drops
  • Environment Controlled: Simple boolean flag to enable/disable

Tools it exposes

Once connected, the assistant can call these 3 tools directly:

  • Architecture — The Architecture tool exposed by this server
  • Deploy — 1. mcp-proxy is installed automatically when you build the HTTP image — it lives in requirements-http.txt and the provided compose file sets the
  • Security — mcp-proxy does not provide server-side authentication. Anything that can reach the HTTP endpoint can call every tool. Mitigations:

Installing the synology mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Configuration

Before the server will start you need to supply 6 environment variables: SYNOLOGY_URL, SYNOLOGY_USERNAME, SYNOLOGY_PASSWORD, AUTO_LOGIN, ENABLE_XIAOZHI, XIAOZHI_TOKEN. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

Cloud and DevOps servers put infrastructure on speaking terms with your assistant, so "why is this broken?" is answered from real state rather than a generic checklist. Synology sits in that group, and the shape of its toolset — Architecture, Deploy, Security — tells you what it is really for. Worth comparing against the other cloud devops servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • Maintained by atom2ueki, written in Python.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the synology mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
ArchitectureThe Architecture tool exposed by this server.
Deploy1. mcp-proxy is installed automatically when you build the HTTP image — it lives in requirements-http.txt and the provided compose file sets the INSTALL_HTTP=true build arg (it is not in the default stdio/Xiaozhi image).
Securitymcp-proxy does **not** provide server-side authentication. Anything that can reach the HTTP endpoint can call every tool. Mitigations:

How to install the Synology MCP server

{
  "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"
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
SYNOLOGY_URLEndpoint or connection string the server talks to.Yes
SYNOLOGY_USERNAMEConfiguration value read at startup.Optional
SYNOLOGY_PASSWORDConfiguration value read at startup.Optional
AUTO_LOGINConfiguration value read at startup.Optional
ENABLE_XIAOZHIConfiguration value read at startup.Optional
XIAOZHI_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Synology to Architecture.
  • Use Synology to Deploy.
  • Use Synology to Security.

Frequently asked questions

It connects Synology to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (Architecture, Deploy, Security) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Synology directly.