SynoLink MCP 服务器

一个 Node.js 服务器，实现了用于 Synology NAS 文件操作的 Model Context Protocol (MCP)。 此服务器允许您通过 Claude 或其他兼容的 AI 助手与您的 Synology NAS 设备进行交互。

功能

• 登录/注销 Synology DSM
• 列出文件和文件夹
• 下载文件内容
• 上传文件
• 创建文件夹
• 删除文件/文件夹
• 移动/重命名文件和文件夹
• 搜索功能
• 创建和列出共享链接
• 获取服务器信息
• 获取配额信息

前提条件

• Node.js 18 或更高版本
• npm 或 yarn
• 具有 DSM 6.0 或更高版本的 Synology NAS
• 对您的 Synology NAS 的网络访问

安装

克隆此存储库：

git clone https://github.com/Do-Boo/MCP-SynoLink.git
cd MCP-SynoLink

安装依赖项：

npm install

构建项目：

npm run build

与 Claude Desktop 一起使用

Node.js 方法

将其添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "synolink": {
      "command": "node",
      "args": [
        "/path/to/MCP-SynoLink/dist/index.js",
        "https://your-synology-url:port",
        "your-username",
        "your-password"
      ]
    }
  }
}

Docker 方法

构建 Docker 镜像：

docker build -t mcp/synolink .

然后将其添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "synolink": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/synolink",
        "https://your-synology-url:port",
        "your-username",
        "your-password"
      ]
    }
  }
}

安全提示

始终小心处理凭据。 当前的实现将密码作为命令行参数发送，这可能在进程列表中可见。 为了提高生产环境中的安全性，请考虑实施替代身份验证方法。

API 文档

服务器提供以下工具：

身份验证工具

• login

  • 使用 Synology NAS 进行身份验证
  • 无需参数（使用来自命令行的凭据）

• logout

  • 从 Synology NAS 注销
  • 无需参数

文件管理工具

• list_folders

  • 列出目录中的文件和文件夹
  • 输入：path (字符串) - 从中列出文件的路径，例如 '/photos'

• get_file

  • 获取文件的内容
  • 输入：path (字符串) - Synology NAS 上文件的完整路径

• upload_file

  • 将文件上传到 Synology NAS
  • 输入：
    • path (字符串) - Synology NAS 上的目标路径，包括文件名
    • content (字符串) - 要上传的文件的内容

• create_folder

  • 创建一个新文件夹
  • 输入：
    • path (字符串) - 创建文件夹的完整路径
    • name (字符串) - 新文件夹的名称

• delete_item

  • 删除文件或文件夹
  • 输入：path (字符串) - 要删除的文件或文件夹的完整路径

• move_item

  • 移动或重命名文件或文件夹
  • 输入：
    • source (字符串) - 源文件或文件夹的完整路径
    • destination (字符串) - 目标位置的完整路径

搜索和信息工具

• search

  • 搜索文件和文件夹
  • 输入：
    • keyword (字符串) - 搜索关键字
    • path (字符串, 可选) - 要搜索的路径，默认为 "/"

• get_share_links

  • 获取或创建文件或文件夹的共享链接
  • 输入：path (字符串) - 获取共享链接的路径

• get_server_info

  • 获取有关 Synology 服务器的信息
  • 无需参数

• get_quota_info

  • 获取卷的配额信息
  • 输入：volume (字符串, 可选) - 卷名，如果省略则显示所有卷

许可证

MIT 许可证

致谢

• Synology Web API
• Model Context Protocol