PluginBench
MCP Server

Virtual Filesystem MCP Server

io.github.lu-zhengda/virtual-fs

RepositoryRegistry

What is the Virtual Filesystem MCP server?

PostgreSQL-backed virtual filesystem for agents: session isolation, shared stores, POSIX ops, RLS.

How to install Virtual Filesystem

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • DATABASE_URL
    required
    secret

    PostgreSQL connection string (e.g. postgresql://user:pass@host:5432/dbname)

  • VFS_AUTO_INIT

    Auto-create database tables on startup (set to 'true' for first run)

  • VFS_SESSION_ID

    Deterministic session ID for resumable sessions across restarts

  • VFS_ENABLE_RLS

    Enable PostgreSQL Row Level Security for database-enforced session isolation

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "virtual-fs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-virtual-fs"
      ],
      "env": {
        "DATABASE_URL": "<YOUR_DATABASE_URL>",
        "VFS_AUTO_INIT": "<YOUR_VFS_AUTO_INIT>",
        "VFS_SESSION_ID": "<YOUR_VFS_SESSION_ID>",
        "VFS_ENABLE_RLS": "<YOUR_VFS_ENABLE_RLS>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "virtual-fs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-virtual-fs"
      ],
      "env": {
        "DATABASE_URL": "<YOUR_DATABASE_URL>",
        "VFS_AUTO_INIT": "<YOUR_VFS_AUTO_INIT>",
        "VFS_SESSION_ID": "<YOUR_VFS_SESSION_ID>",
        "VFS_ENABLE_RLS": "<YOUR_VFS_ENABLE_RLS>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "virtual-fs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-virtual-fs"
      ],
      "env": {
        "DATABASE_URL": "<YOUR_DATABASE_URL>",
        "VFS_AUTO_INIT": "<YOUR_VFS_AUTO_INIT>",
        "VFS_SESSION_ID": "<YOUR_VFS_SESSION_ID>",
        "VFS_ENABLE_RLS": "<YOUR_VFS_ENABLE_RLS>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "virtual-fs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-virtual-fs"
      ],
      "env": {
        "DATABASE_URL": "<YOUR_DATABASE_URL>",
        "VFS_AUTO_INIT": "<YOUR_VFS_AUTO_INIT>",
        "VFS_SESSION_ID": "<YOUR_VFS_SESSION_ID>",
        "VFS_ENABLE_RLS": "<YOUR_VFS_ENABLE_RLS>"
      }
    }
  }
}
Claude Code
claude mcp add virtual-fs --env DATABASE_URL=<YOUR_DATABASE_URL> --env VFS_AUTO_INIT=<YOUR_VFS_AUTO_INIT> --env VFS_SESSION_ID=<YOUR_VFS_SESSION_ID> --env VFS_ENABLE_RLS=<YOUR_VFS_ENABLE_RLS> -- npx -y mcp-virtual-fs

Related MCP servers

Python Exec Sandbox

Sandboxed Python execution for AI agents. PEP 723 inline deps, multi-version Python, zero pollution.

View repository →