mcp-synology-filestation

MCP server for Synology FileStation — browse, search, transfer, and manage files on your NAS via Claude.

Status

Work in progress. See SPEC.md for the planned tool set.

Planned Tools

Tool	Description
list_shares	List all shared folders
list_dir	Directory contents with pagination and sorting
get_info	File or folder metadata
search	Recursive pattern search
download	Download a file (base64 content)
create_folder	Create a new directory
rename	Rename a file or folder
move	Move to a new location
copy	Copy to a new location
delete	Delete a path (requires confirmation)
upload	Upload a file from base64 content

Setup

uv tool install git+https://gitea.gecheckt.de/marcus/mcp-synology-filestation.git
mcp-synology-filestation setup

Development

uv sync --dev
uv run pytest
uv run ruff check src/
uv run ruff format src/