mcp-server-synology

概述

这是一个全面的 MCP 服务器，让 Claude、Cursor、Continue 等 AI 助手能够与群晖 NAS 设备交互。它提供安全认证和会话管理，并支持 Docker 部署以便于设置。服务器暴露了多种工具用于文件系统操作、下载站管理、系统健康监控和 NFS 配置。一个独特功能是其统一架构，同时支持基于 stdio 的客户端（Claude/Cursor）和基于 WebSocket 的客户端（Xiaozhi）。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• synology_status

  Check authentication status and active sessions

  试试:Check if I'm authenticated to the Synology NAS试试:What's the current session status?
• list_shares

  List all available NAS shares

  试试:Show me all the shared folders on my NAS试试:What shares are available?
• list_directorypath: string (required)

  List directory contents with metadata

  试试:List the contents of /volume1/documents试试:What files are in the photos directory?
• create_filepath: string (required), content?: string, overwrite?: boolean

  Create new files with content

  试试:Create a new file at /volume1/notes.txt with content 'Meeting notes'试试:Make a new config file with default settings
• ds_list_tasksoffset?: number, limit?: number

  List all download tasks with status

  试试:Show me all current download tasks试试:What downloads are currently active?
• ds_create_taskuri: string (required), destination?: string

  Create new download task

  试试:Download this file: https://example.com/largefile.zip试试:Add a torrent to download station
• synology_system_info

  Get system model, serial, DSM version, uptime, temperature

  试试:Show me my NAS system information试试:What's the model and serial number of my Synology?
• synology_disk_health

  List all physical disks with SMART status, model, temp, size

  试试:Check the health status of all my disks试试:Are any drives showing SMART errors?
• synology_volume_status

  List all volumes with status, size, usage, filesystem type

  试试:Show me the status and usage of all volumes试试:How much free space do I have on each volume?
• search_filespath: string (required), pattern: string (required)

  Search files matching pattern

  试试:Find all PDF files in the documents folder试试:Search for any files named 'report' in the share
• synology_health_summary

  Aggregate system info, utilization, disk health, and volume status

  试试:Give me a complete health summary of my NAS试试:What's the overall status of my system?
• synology_nfs_status

  Get NFS service status and configuration

  试试:Check the status of the NFS service试试:Is NFS enabled on my NAS?

可对比工具

安装

git clone https://github.com/atom2ueki/mcp-server-synology.git
cd mcp-server-synology

cp env.example .env

SYNOLOGY_URL=http://192.168.1.100:5000
SYNOLOGY_USERNAME=your_username
SYNOLOGY_PASSWORD=your_password
AUTO_LOGIN=true
VERIFY_SSL=false

docker-compose up -d

{
  "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"
    }
  }
}

FAQ

我可以将此用于多个群晖 NAS 设备吗？

是的，服务器支持通过遵循 XDG 基础目录规范的 settings.json 文件进行多 NAS 设置。

这适用于启用了 2FA 的账户吗？

不行，您需要创建一个没有 2FA 的专用账户，因为 MCP 服务器无法处理 2FA 提示。

mcp-server-synology 对比