Synology MCP Server

@atom2ueki

代码仓库

基本信息

分类

开发工具

许可证

MIT

传输方式

stdio

作者

atom2ueki

关于 Synology MCP Server

💾 Model Context Protocol (MCP) server for Synology NAS - Enables AI assistants (Claude, Cursor, Continue) to manage files, downloads, and system operations through secure API integration. Features Docker deployment, auto-authentication, and comprehensive file system tools.

#mcp#synology#mcp-server

Synology MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-synology": {
      "command": "python",
      "args": [
        "main.py"
      ]
    }
  }
}

Synology MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Synology MCP Server?

A Model Context Protocol (MCP) server for Synology NAS devices. It enables AI assistants like Claude and Cursor to manage files, downloads, and system health through secure authentication and session management. The unified server supports both Claude/Cursor (stdio) and Xiaozhi (WebSocket) simultaneously.

How to use Synology MCP Server?

Clone the repository, copy env.example to .env, and configure the Synology NAS URL, username, and password. Run with docker-compose up -d (or python main.py for local execution). Then add the server to your MCP client (Claude Desktop, Cursor, Continue, or Codeium) using the provided JSON configuration. For remote access, deploy with the HTTP/SSE image and front with a TLS-terminating reverse proxy.

Key features of Synology MCP Server

Unified server supports both stdio and WebSocket clients simultaneously
File system operations: list, search, create, delete, rename, move
Download Station management: create, pause, resume, delete tasks
Health monitoring: system info, utilization, disk health, volumes, network, UPS
Container Manager: list, get, start, stop containers

Use cases of Synology MCP Server

AI assistant to browse, upload, and organize files on a Synology NAS
Automate download tasks via Download Station using URLs or magnet links
Monitor NAS health (CPU, memory, disk SMART, UPS status) from a chat interface
Deploy a remote MCP endpoint so Claude/Cursor can access the NAS over the internet

常见问题

What dependencies are required to run the server?

Docker is the primary method; alternatively, Python 3 with the packages in `requirements.txt`. The HTTP/SSE deployment also installs `mcp-proxy`.

How do I make the server accessible remotely?

Use the provided `docker-compose.http.yml` file to expose the MCP server over HTTP/SSE on port 8765, then front it with a reverse proxy (DSM Login Portal, Nginx, etc.) for TLS termination and optional authentication.

Does the server support multiple client protocols simultaneously?

Yes. When `ENABLE_XIAOZHI=true` is set in `.env`, the server acts as a bridge serving both stdio (for Claude/Cursor) and WebSocket (for Xiaozhi) at the same time.

What authentication is used?

The server authenticates with the Synology NAS using the credentials stored in the `.env` file (`SYNOLOGY_USERNAME`, `SYNOLOGY_PASSWORD`). The HTTP/SSE endpoint itself has no built-in authentication; it should be secured at the reverse proxy level.

Can I use this server with Continue (VS Code extension)?

Yes. Add the same Docker (or Python) configuration as for Claude/Cursor to your `./continue/config.json` `mcpServers` block.

开发工具分类下的更多 MCP 服务器

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U

Ramen

bkraad47

Multi-zone MCP server for GKE/EKS/AKS: Python tools from git, NeMo guardrails, SSO, autoscaling.

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac