vega-llc/dk-synology-mcp

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

5 stars 6 forks 品質 59 トレンド 13

Comprehensive Synology NAS MCP server — 87 tools across 15 service modules (FileStation, Docker, Backup, Photos, VMM, and more)

概要

Comprehensive Synology NAS management through the Model Context Protocol. Control file operations, downloads, backups, Docker containers, photos, virtual machines, snapshots, and more — all from Claude or any MCP-compatible client. - across 15 service categories - — manage up to 9 NAS units from a single server - compatibility - — HTTPS with optional certificate verification - — OTP code support per NAS - Python 3.10+ - One or more Synology NAS units with DSM 6.x or 7.x - An admin (or delegated) account on each NAS macOS with Homebrew Python requires a virtual environment: The .venv folder is already in .gitignore and won't be committed. Before configuring the server, gather these details from each NAS: 1. : Your NAS IP address (e.g., 192.168.1.100). Find it in DSM under Control Panel > Network > Network Interface. 2. : Default is 5000 (HTTP) or 5001 (HTTPS). Find it in Control Panel > Login Portal > DSM tab. 3. : An admin account, or a user with delegated admin permissions.

README

以下は原文 README の抜粋です。原文を見る。

Synology MCP Server

Features

87 tools across 15 service categories
Multi-NAS support — manage up to 9 NAS units from a single server
DSM 7 and DSM 6 compatibility
Secure connections — HTTPS with optional certificate verification
Two-factor auth — OTP code support per NAS

Tool Categories

Category	Tools	Description
File Management	16	List, search, create folders, copy/move, delete, compress, share links, file tree
System Info	6	DSM info, CPU/RAM utilization, storage, network, services, health dashboard
Download Station	8	Create downloads (URL/magnet), pause/resume, delete, stats, config
Cloud Sync	5	List sync tasks, status, pause/resume, logs
Backup (HyperBackup)	5	List tasks, status, run, cancel, integrity check
Docker	8	List containers/images/networks, start/stop/restart, logs, resource usage
Task Scheduler	5	List scheduled tasks, info, run, enable/disable, output
Photos	4	List albums, browse, search, album items
Packages	4	List installed packages, start/stop, package info
Users & Groups	4	List users/groups, user info, group members
Shared Folders	3	List shares, folder info, permissions
Virtualization (VMM)	5	List VMs, info, power on/off, graceful shutdown
Snapshots	4	List snapshots, create, delete, replication tasks
Active Backup	6	List tasks/devices, info, logs, restore points
System	4	List connections, test connectivity, disconnect, capabilities

Installation

Prerequisites

Python 3.10+
One or more Synology NAS units with DSM 6.x or 7.x
An admin (or delegated) account on each NAS

Install from source (recommended)

macOS with Homebrew Python requires a virtual environment:

git clone https://github.com/DRVBSS/dk-synology-mcp.git
cd dk-synology-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install .

The .venv folder is already in .gitignore and won’t be committed.

Install in development mode

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Verify installation

# With venv activated:
synology-mcp --help

# Or without activating:
.venv/bin/synology-mcp --help

Configuration

Step 1: Find your Synology NAS connection details

Before configuring the server, gather these details from each NAS:

Host/IP: Your NAS IP address (e.g., 192.168.1.100). Find it in DSM under Control Panel > Network > Network Interface.
Port: Default is 5000 (HTTP) or 5001 (HTTPS). Find it in Control Panel > Login Portal > DSM tab.

GitHub で README 全文を見る

インストール

docker run --env-file .env -i synology-mcp

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "synology": {
      "command": "/full/path/to/dk-synology-mcp/.venv/bin/synology-mcp",
      "env": {
        "SYNOLOGY_NAS1_NAME": "ds923",
        "SYNOLOGY_NAS1_HOST": "192.168.1.100",
        "SYNOLOGY_NAS1_PORT": "5001",
        "SYNOLOGY_NAS1_USERNAME": "mcp-service",
        "SYNOLOGY_NAS1_PASSWORD": "your-password",
        "SYNOLOGY_NAS1_SECURE": "true",
        "SYNOLOGY_NAS1_CERT_VERIFY": "false",
        "SYNOLOGY_NAS1_DSM_VERSION": "7",
        "SYNOLOGY_DEFAULT_NAS": "ds923"
      }
    }
  }
}