Filesystem

Exposes specified local directories to an MCP client with controlled path access and read permissions.

other

0

GitHub Stars

other

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-philgei_mcp_server_filesystem": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/"
      ]
    }
  }
}

The MCP Filesystem Server lets you expose local directories as an MCP integration, enabling an MCP client to access your filesystem through a controlled, pluggable interface. You specify which directories are allowed, and the server enforces strict path validation to prevent accessing outside those directories. This makes it easy to browse and interact with your files from an MCP client without granting broad filesystem access.

How to use

You connect the filesystem server to an MCP client by registering a local server configuration. Define one or more allowed directories, then start the server through the MCP client setup so it appears as an available integration. Once registered, you can browse, read, and interact with the files in the permitted directories from the client.

How to install

Prerequisites you need before installing the server:

Python and the UVX toolchain must be installed on your system.
You should have a working Python environment activated when installing and running the server.

Step 1: Install using UVX

uv venv
.venv\Scripts\activate  # On Windows
uv pip install -e .

Additional sections

Configuration for your MCP client is provided as a JSON snippet. You can point the client to one or more directories that you wish to expose through the MCP filesystem server. Each entry defines a command and the arguments that specify allowed directories.

{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/"  // Replace with your desired directory
      ]
    }
  }
}

{
  "mcpServers": {
    "myFiles": {
      "command": "mcp-server-filesystem",
      "args": [
        "D:/",
        "C:/Users/YourUsername/Documents",
        "~/Desktop"
      ]
    }
  }
}

Security

Only directories specified in the args array will be accessible. The server enforces strict path validation to prevent access outside allowed directories.

Troubleshooting

If you encounter issues, verify the following steps to resolve common problems.

Command not found: Ensure the package is installed and your Python environment is activated (check with uv pip list).
Access denied: Confirm that the directories in args exist and you have read permissions for them.
Server not showing in your MCP client: Validate your config syntax and restart the client after changes.