← Index

Virtual Filesystem

io.github.lu-zhengda/virtual-fs·v0.2.2·Databases
Quality Score
86
/100

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

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "virtual-fs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-virtual-fs"
      ],
      "env": {
        "DATABASE_URL": "<your-database_url>",
        "VFS_AUTO_INIT": "<vfs_auto_init>",
        "VFS_SESSION_ID": "<vfs_session_id>",
        "VFS_ENABLE_RLS": "<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": "<vfs_auto_init>",
        "VFS_SESSION_ID": "<vfs_session_id>",
        "VFS_ENABLE_RLS": "<vfs_enable_rls>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y mcp-virtual-fs
§02  Environment variables
DATABASE_URL
requiredsecret

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

§03  MCP Quality Score  ·  methodology
freshness
21
completeness
20
installability
25
documentation
15
stability
5
§04  Alternatives in Databases