一款适用于Synology NAS设备的模型上下文协议（MCP）服务器。使AI助手能够通过安全认证和会话管理管理文件和下载。

** 🌟 新：统一服务器同时支持 Claude/Cursor（stdio）和 Xiaozhi（WebSocket）！**

📦 从 PyPI 安装

无需克隆仓库——直接从 PyPI 安装包：

这会安装两个等效命令：synology-mcp 和 mcp-server-synology。

对于MCP客户端，uvx是最简单的选择——它会自动下载和缓存包，无需手动安装或本地克隆：

配置存在于包之外，因此其工作方式与源检验相同：创建配置选项中描述的~/.config/synology-mcp/settings.json。

🚀 Docker 快速入门

1️¶ 设置环境

2️# 配置 .env 文件

基础配置（仅限Claude/光标）:

扩展配置（同时是Claude/光标+小字）:

.env 在 运行时读取，绝不会被嵌入图像中 — docker-compose.yml 通过 env_file 注入其条目作为容器环境变量，因此 文件本身不存在于容器内部。这是可选的：如果你

💾 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!

📦 Install from PyPI

No need to clone the repository — install the package directly from PyPI:

# With pip
pip install mcp-server-synology

# Or with pipx (isolated environment)
pipx install mcp-server-synology

# Or with uv
uv tool install mcp-server-synology

This installs two equivalent commands: synology-mcp and mcp-server-synology.

For MCP clients, uvx is the simplest option — it downloads and caches the package automatically, no manual install or local clone required:

{
  "mcpServers": {
    "synology": {
      "command": "uvx",
      "args": ["mcp-server-synology"]
    }
  }
}

Configuration lives outside the package, so it works the same as a source checkout: create ~/.config/synology-mcp/settings.json as described in Configuration Options.

🚀 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/

.env is read at run time, never baked into the image — docker-compose.yml injects its entries as container environment variables via env_file, so the file itself is not present inside the container. It is optional: if you configure NASes with settings.json instead (recommended), you can skip this file entirely.

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 the package and its dependencies (from PyPI, or from a clone with 'pip install .')
pip install mcp-server-synology

# Run with environment control
python main.py

🔌 Client Setup