Remote File Server MCP Server

An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that bridges **Claude Desktop** (or any MCP client) to your **SMB/CIFS

Local serverstdioPython

What is the Remote File Server MCP Server?

An MCP (Model Context Protocol) server that bridges Claude Desktop (or any MCP client) to your SMB/CIFS network share —

Configuration and credentials

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_filespath (optional)
read_filepath
get_file_infopath
search_filespattern, path (optional), max_depth (optional)

How to install the Remote File Server MCP Server

{
  "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": "YOUR_SMB_PASSWORD"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.11+ - Network access to the SMB server (port 445 by default) - SMB credentials with read permissions on the share
VariableDescriptionRequired
SMB_HOSTDeclared in the maintainer’s client configuration.Check documentation
SMB_SHAREDeclared in the maintainer’s client configuration.Check documentation
SMB_USERNAMEDeclared in the maintainer’s client configuration.Check documentation
SMB_PASSWORDDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Remote File Server MCP to list files.”
  • “Use Remote File Server MCP to read file.”
  • “Use Remote File Server MCP to get file info.”

Frequently asked questions

An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that bridges **Claude Desktop** (or any MCP client) to your **SMB/CIFS network share** — Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.