Remote File Server

Give any AI assistant read access to your SMB/CIFS file shares — securely, in minutes.

AnMCP (Model Context Protocol)server that bridgesClaude Desktop(or any MCP client) to yourSMB/CIFS network share— Windows file servers, NAS drives, Samba shares, anything SMB.

flowchart LR A("🤖 Claude Desktop\nor any MCP client"):::client B("🔌 file-server-mcp\n<i>this server</i>"):::server C("🗄️ SMB File Server\nWindows · NAS · Samba"):::storage A -- "MCP / stdio" --> B B -- "SMB 445 · encrypted" --> C classDef client fill:#7c3aed,color:#fff,stroke:none classDef server fill:#2563eb,color:#fff,stroke:none classDef storage fill:#0f766e,color:#fff,stroke:none

pip install -e /path/to/remote-file-server

uv run --directory /path/to/remote-file-server file-server-mcp

python3 -m venv .venv && source .venv/bin/activate pip install -r requirements.txt python server.py

{ "mcpServers": { "file-server": { "command": "uv", "args": ["run", "--directory", "/path/to/remote-file-server", "file-server-mcp"], "env": { "SMB_HOST": "192.168.1.100", "SMB_SHARE": "my_share", "SMB_USERNAME": "my_user", "SMB_PASSWORD": "my_password" } } } }

pip/uv pip (console script entry point):

{ "mcpServers": { "file-server": { "command": "file-server-mcp", "env": { "SMB_HOST": "192.168.1.100", "SMB_SHARE": "my_share", "SMB_USERNAME": "my_user", "SMB_PASSWORD": "my_password", "SMB_PORT": "445", "ALLOWED_PATHS": "reports,finance", "AUDIT_LOG_PATH": "/var/log/file-server-mcp/audit.jsonl" } } } }

Security note:This config file contains credentials — restrict its permissions (chmod 600on macOS/Linux).

{ "mcpServers": { "file-server-prod": { "command": "file-server-mcp", "env": { "SMB_HOST": "10.0.0.10", "SMB_SHARE": "Production", "...": "..." } }, "file-server-dev": { "command": "file-server-mcp", "env": { "SMB_HOST": "10.0.0.20", "SMB_SHARE": "Development", "...": "..." } } } }

- SMB packet signingis required on all connections.
- Path traversalis blocked —..segments are rejected before any SMB call.
- Sensitive file denylistcovers.env,.key,.pem,.bak,id_rsa,.pfx,.p12,.token,.netrc,.htpasswd, keystore files, and more. For production, combine this withALLOWED_PATHSto restrict access to only the directories the model needs.
- File size limitprevents reading files that would overflow the context window.
- Audit loggingrecords every tool call in JSON (operation, path, outcome, tool-specific metadata) — never file contents.
- Error messages are sanitised— internal hostnames, UNC paths, and credentials are never exposed to the client.

- Python 3.11+
- Network access to the SMB server (port 445 by default)
- SMB credentials with read permissions on the share

Provides access to an FTP server for file operations.

Manage files and downloads on Synology NAS devices using an AI assistant.

Upload, retrieve, pin, and manage encrypted files on IPFS via a simple API accessible as MCP tools

MCP server that moves files between your filesystem and cloud storage.

Explore and retrieve content from Volcengine's Tinder Object Storage (TOS) using natural language queries.

A cross-platform filesystem server for Linux, macOS, and Windows with secure path restrictions.

A server providing comprehensive file system operations, automatically downloaded and built on first use.

A server for performing filesystem operations such as reading/writing files, managing directories, and searching.

A server for comprehensive file and directory management on the local file system.

A server for local folder operations and file system access.