# mcp-server-synology — Synology NAS MCP Server

> Synology NAS MCP server for file/download ops from Claude Desktop, Cursor, and Continue. Runs via Docker or Python. Verified 98★; pushed 2026-05-14.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
git clone https://github.com/atom2ueki/mcp-server-synology.git
cd mcp-server-synology
cp env.example .env
docker-compose up -d --build
```

## Intro

Synology NAS MCP server for file/download ops from Claude Desktop, Cursor, and Continue. Runs via Docker or Python. Verified 98★; pushed 2026-05-14.

**Best for:** Home lab and DevOps users who want safe, tool-based NAS automation from AI clients

**Works with:** Docker Compose or Python; MCP clients like Claude Desktop/Cursor (README)

**Setup time:** 12-25 minutes

### Key facts (verified)

- GitHub: 98 stars · 18 forks · pushed 2026-05-14.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-backed entrypoint: `docker-compose`.

## 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**

![Synology MCP Server](assets/banner.png)

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
```bash
**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):**
```bash
**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):**
```bash
**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:**

```bash
**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

```bash
**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`

```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.

## Source & Thanks

> Created by [atom2ueki](https://github.com/atom2ueki). Licensed under MIT.
>
> [atom2ueki/mcp-server-synology](https://github.com/atom2ueki/mcp-server-synology) — ⭐ 98

Thanks to the upstream maintainers and contributors for publishing this work under an open license.

---

<!-- ZH -->

## Quick Use

```bash
git clone https://github.com/atom2ueki/mcp-server-synology.git
cd mcp-server-synology
cp env.example .env
docker-compose up -d --build
```

## Intro

mcp-server-synology 将群晖 NAS 的文件/下载等能力封装为 MCP 工具，可接入 Claude Desktop、Cursor、Continue 等客户端，支持 Docker Compose 与 Python 两种运行方式；已验证 98★，更新于 2026-05-14。

**Best for:** 希望用工具化方式让 AI 客户端安全管理 NAS 的家庭实验室/运维用户

**Works with:** Docker Compose 或 Python；可接入 Claude Desktop/Cursor 等 MCP 客户端（见 README）

**Setup time:** 12-25 minutes

### Key facts (verified)

- GitHub：98 stars · 18 forks；最近更新 2026-05-14。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中可对照的入口：`docker-compose`。

## Main

- 先从低风险任务开始（列文件、查看下载状态），再逐步开启写操作，避免误删误改。

- 优先用 Docker Compose 固化运行环境；按 README 示例在 MCP 客户端配置里用 `docker-compose run` 调用。

- 把群晖账号信息放到 `.env` 并定期轮换，不要把密码粘到对话里。

- 如需多客户端/多模式支持，按 README 的 unified server 说明配置 stdio/WebSocket。

### README (excerpt)

**💾 Synology MCP Server**

![Synology MCP Server](assets/banner.png)

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
```bash
**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):**
```bash
**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):**
```bash
**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:**

```bash
**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

```bash
**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`

```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 包含 Docker Quick Start，并提供本地 Python 运行方式（`pip install -r requirements.txt`、`python main.py`）。
- README 给出 Claude Desktop、Cursor、Continue、Codeium 的 MCP 配置示例。
- GitHub topics 包含 `mcp` 与 `synology`（已通过 GitHub API 复核）。

### FAQ

- **必须用 Docker 吗？**：不必须：README 也提供 Python 运行方式；但 Docker 对大多数人更省心。
- **支持哪些客户端？**：README 给了 Claude Desktop、Cursor、Continue 等配置示例。
- **怎么更安全？**：先只读、再逐步放开；控制凭据与权限范围，只做 NAS 必需操作。

## Source & Thanks

> Created by [atom2ueki](https://github.com/atom2ueki). Licensed under MIT.
>
> [atom2ueki/mcp-server-synology](https://github.com/atom2ueki/mcp-server-synology) — ⭐ 98


---
Source: https://tokrepo.com/en/workflows/mcp-server-synology-synology-nas-mcp-server
Author: MCP Hub