drio
Open app

File system MCP

Source

This is a File system mcp server that could allow an LLM to read and list files from a specified safe directory on your local machine.

Catalog onlyCatalog onlySTDIO

Overview

Filesys is a lightweight MCP server built with Python that allows an LLM to read and list files from a specified directory on your local machine securely.

To use Filesys, clone the repository, install the dependencies, configure the directory in config/config.json, and start the server using python run.py. You can then interact with the server using the example client or any MCP-compatible client.

  • Securely exposes file contents and metadata from a preconfigured directory. - Provides endpoints for listing files and reading file contents. - Validates paths to prevent directory traversal attacks.
  1. Listing files in a specific directory for LLM processing.
  2. Reading file contents and metadata for analysis or processing.
  3. Integrating with other applications that require file access through MCP protocol.

Add to your AI client

Use these steps to connect File system MCP in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "filesys-ibz-04": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesys-ibz-04"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "filesys-ibz-04": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesys-ibz-04"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "filesys-ibz-04": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesys-ibz-04"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "filesys-ibz-04": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesys-ibz-04"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "filesys-ibz-04": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesys-ibz-04"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "filesys-ibz-04": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesys-ibz-04"
      ]
    }
  }
}

FAQ

Is Filesys secure?

Yes! Filesys implements basic security measures to restrict file access to the configured directory.

How do I customize the directory?

You can modify the `config/config.json` file to point to a different directory as needed.

Can I contribute to Filesys?

Yes! Contributions are welcome. Fork the repository and submit a pull request with your changes.

File systems