mcp-server-synology
让AI助手通过MCP协议安全地管理你的群晖NAS文件和下载任务。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:mcp-server-synology。 它的用途是:让AI助手通过MCP协议安全地管理你的群晖NAS文件和下载任务。 完整的 Skill 内容见:https://321skill.com/skills/mcp-server-synology/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我把上周的会议录音文件从NAS的‘工作记录’文件夹里找出来,并转成文字摘要。”,它会通过MCP服务器连接到你的群晖NAS,定位文件,并调用其他工具进行语音转写和摘要生成。或者
对AI说:“检查一下NAS上‘下载’文件夹里有没有新完成的电影,有的话把它们移动到‘媒体库’对应的分类里。”,它会自动执行文件查找和整理操作。
介绍
Synology MCP Server 是一个基于模型上下文协议(MCP)的服务器,专门为群晖NAS设备设计。它解决了AI助手无法直接访问和管理本地或内网NAS资源的问题,通过安全的认证和会话管理,为AI赋予了文件操作和下载管理的能力。
使用方式非常灵活,主要通过Docker一键部署。用户只需克隆仓库、配置包含NAS地址和账号的.env文件,然后运行docker-compose即可启动服务。该服务器创新性地同时支持Claude/Cursor等通过stdio通信的客户端,以及小智(Xiaozhi)这类通过WebSocket连接的平台,实现了“一次部署,多方可用”。
这个Skill非常适合拥有群晖NAS,并希望将AI助手融入日常数字工作流的用户。无论是需要AI帮忙整理文件、管理下载任务的内容创作者,还是希望自动化处理NAS上数据的开发者或运维工程师,都能从中受益。对于家庭用户,也能通过语音或自然语言指令更方便地管理家庭媒体库。
在使用前,请确保你的NAS已开启并可从运行MCP服务器的机器访问。配置.env文件时,务必妥善保管NAS登录凭证。对于生产环境,建议使用更安全的连接方式(如VPN)并谨慎评估自动登录(AUTO_LOGIN)功能的风险。
核心特点
核心区别在于其“双模支持”架构,一个服务器实例可同时为Claude/Cursor等本地MCP客户端和小智(Xiaozhi)等云端AI平台提供服务,无需为不同平台部署和维护多个服务端。
注意事项
不适合无法从运行MCP客户端的机器直接访问群晖NAS管理界面的网络环境(如严格隔离的网络)。
常见问题
必须使用Docker吗?
不是必须,也支持直接运行Python脚本,但Docker方式更简单,能更好地管理依赖和环境。
支持哪些AI助手或客户端?
支持Claude Desktop、Cursor、Continue、Codeium等任何兼容MCP stdio协议的客户端,以及通过WebSocket支持小智(Xiaozhi)平台。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/mcp-server-synology/raw/index.md 读取 mcp-server-synology 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/mcp-server-synology/raw/index.md(查看排版版本)