Сервер Model Context Protocol (MCP) для устройств Synology NAS. Позволяет ассистентам ИИ управлять файлами и загрузками через защищённую аутентификацию и управление сессиями.

** 🌟 НОВОЕ: Unified server поддерживает одновременно Claude/Cursor (stdio) и Xiaozhi (WebSocket)!**

📦 Установка с PyPI

Нет необходимости клонировать репозиторий — устанавливайте пакет напрямую из PyPI:

Это устанавливает две эквивалентные команды: synology-mcp и mcp-server-synology.

Для MCP-клиентов uvx — самый простой вариант: пакет автоматически загружает и кэширует, без необходимости ручной установки или локального клонирования:

Конфигурация работает вне пакета, поэтому работает так же, как проверка исходного кода: создайте ~/.config/synology-mcp/settings.json, как описано в Параметрах конфигурации.

🚀 Быстрый старт с Docker

1️⃣ Среда настройки

2️⃣ Конфигурировать файл .env

Базовая конфигурация (только Клод/курсор):

Расширенная конфигурация (и Claude/Cursor + Xiaozhi):

.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