mcp-server-synology — Synology NAS MCP Server

Main

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

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

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

• 如需多客户端/多模式支持，按 README 的 unified server 说明配置 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 包含 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 必需操作。