Save-To-NAS MCP

An MCP server for saving files and folders to a local NAS over NFS. Eliminates repetitive steps when transferring data to NAS storage.

Installation

Via npm

npm install -g save-to-nas-mcp

From source

git clone https://github.com/danielrosehill/Save-To-NAS-MCP.git
cd Save-To-NAS-MCP
npm install

Configuration

Configure the MCP server with environment variables:

Adding to Claude Code / Claude Desktop

This MCP server uses Streamable HTTP transport. Add to your MCP settings:

{
  "mcpServers": {
    "save-to-nas": {
      "type": "http",
      "url": "http://localhost:3847/mcp"
    }
  }
}

To run the server:

# If installed globally
NAS_IP=192.168.1.100 save-to-nas-mcp

# Or via npx
NAS_IP=192.168.1.100 npx save-to-nas-mcp

# Or from source
NAS_IP=192.168.1.100 npm start

Tools

nas

Unified tool for interacting with your Synology NAS. Supports listing available shares and saving files/folders.

Parameters:

Examples:

List all available NAS shares
→ action: "list"

Save a folder to the Documents share
→ action: "save", source: "/home/user/projects/my-data", share: "Documents"

Save to a subfolder
→ action: "save", source: "./report.pdf", share: "Documents", destination_subfolder: "reports/2024"

How It Works

1. Discovery: Queries the NAS via showmount -e to find available NFS exports

2. Mount Detection: Checks if the target share is already mounted locally

3. Smart Mounting: If not mounted, attempts to mount via NFS (requires sudo)

4. Transfer: Copies files/folders to the destination, preserving attributes

Requirements

• Linux with NFS client tools (nfs-common on Ubuntu/Debian)

• Network access to the NAS

• NFS exports configured on your NAS

• Sudo privileges for mounting unmounted shares

License

MIT