# 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
```bash
npm install -g save-to-nas-mcp
```
### From source
```bash
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:
| Variable | Description | Default |
|----------|-------------|---------|
| `NAS_IP` | IP address of your NAS | `10.0.0.50` |
| `NAS_MOUNT_BASE` | Local directory for NFS mounts | `/mnt/nas` |
| `NAS_VOLUME_PREFIX` | NAS volume path prefix | `/volume1` |
| `PORT` | HTTP server port | `3847` |
## Adding to Claude Code / Claude Desktop
This MCP server uses Streamable HTTP transport. Add to your MCP settings:
```json
{
"mcpServers": {
"save-to-nas": {
"type": "http",
"url": "http://localhost:3847/mcp"
}
}
}
```
To run the server:
```bash
# 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:**
| Parameter | Required | Description |
|-----------|----------|-------------|
| `action` | Yes | `"list"` to show shares, `"save"` to copy files |
| `source` | For save | Path to local file or folder to save |
| `share` | For save | Name of the NAS share (e.g., "Documents", "AI_Art") |
| `destination_subfolder` | No | Subfolder within the share to save to |
| `filter` | No | Filter shares by name (for list action) |
**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
