🚀 SynoLink MCP 服务器

SynoLink MCP 服务器是一个基于 Node.js 实现模型上下文协议（MCP）的服务器，专为 Synology NAS 的文件操作而设计。借助该服务器，您可以通过 Claude 或其他兼容的 AI 助手与 Synology NAS 设备进行交互。

✨ 主要特性

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

📦 安装指南

先决条件

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

安装步骤

1. 克隆此仓库：

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

2. 安装依赖项：

npm install

3. 构建项目：

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 方法

1. 构建 Docker 镜像：

docker build -t mcp/synolink .

2. 然后将以下内容添加到您的 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
  • 不需要任何参数

文件管理工具

共享链接工具

信息工具

注意事项

⚠️ 重要提示

• 确保服务器运行在安全的网络环境中。
• 定期更新凭据以保障安全性。
• 使用 HTTPS 加密通信，特别是在生产环境中。