mcp-server-synology — Synology NAS MCP Server

Main

• Start with read-only or low-risk NAS tasks (listing files, checking downloads) before enabling write operations.

• Use Docker Compose for a consistent runtime, then wire your MCP client config to invoke docker-compose run as in README examples.

• Keep Synology credentials in .env and rotate them; avoid pasting passwords into chat prompts.

• If you need multi-client support, follow README guidance for the unified server modes (stdio/WebSocket).

README (excerpt)

💾 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 session management.

🌟 NEW: Unified server supports both Claude/Cursor (stdio) and Xiaozhi (WebSocket) simultaneously!

🚀 Quick Start with Docker

1️⃣ Setup Environment

**Clone repository**
git clone https://github.com/atom2ueki/mcp-server-synology.git
cd mcp-server-synology

**Create environment file**
cp env.example .env

2️⃣ Configure .env File

Basic Configuration (Claude/Cursor only):

**Required: Synology NAS connection**
SYNOLOGY_URL=http://192.168.1.100:5000
SYNOLOGY_USERNAME=your_username
SYNOLOGY_PASSWORD=your_password

**Optional: Auto-login on startup**
AUTO_LOGIN=true
VERIFY_SSL=false

Extended Configuration (Both Claude/Cursor + Xiaozhi):

**Required: Synology NAS connection**
SYNOLOGY_URL=http://192.168.1.100:5000
SYNOLOGY_USERNAME=your_username
SYNOLOGY_PASSWORD=your_password

**Optional: Auto-login on startup**
AUTO_LOGIN=true
VERIFY_SSL=false

**Enable Xiaozhi support**
ENABLE_XIAOZHI=true
XIAOZHI_TOKEN=your_xiaozhi_token_here
XIAOZHI_MCP_ENDPOINT=wss://api.xiaozhi.me/mcp/

3️⃣ Run with Docker

One simple command supports both modes:

**Claude/Cursor only mode (default if ENABLE_XIAOZHI not set)**
docker-compose up -d

**Both Claude/Cursor + Xiaozhi mode (if ENABLE_XIAOZHI=true in .env)**
docker-compose up -d

**Build and run**
docker-compose up -d --build

4️⃣ Alternative: Local Python

**Install dependencies**
pip install -r requirements.txt

**Run with environment control**
python main.py

🔌 Client Setup

🤖 Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.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"


### Source-backed notes

- README includes a Docker-based Quick Start and an alternative local Python run (`pip install -r requirements.txt`, `python main.py`).
- README provides MCP client configuration examples for Claude Desktop, Cursor, Continue, and Codeium.
- GitHub topics include `mcp` and `synology` (verified via GitHub API).

### FAQ

- **Is Docker required?**: No—README includes a Python run path, but Docker is the simplest for most users.
- **Which clients are supported?**: README shows configs for Claude Desktop, Cursor, Continue, and others.
- **How do I keep it safe?**: Start read-only, limit credentials, and keep tool access scoped to NAS needs.