Virtual Filesystem MCP Server

An MCP server that provides AI agents with a persistent, PostgreSQL-backed virtual filesystem. Supports session-isolated file operations, cross-session shared stores, glob/grep search, and Row Level…

Local serverstdioMIT

What is the Virtual Filesystem MCP Server?

Virtual Filesystem is an MCP project maintained in the lu-zhengda/mcp-virtual-fs repository. The maintainer describes its purpose as “An MCP server that provides AI agents with a persistent, PostgreSQL-backed virtual filesystem. Supports session-isolated file operations, cross-session shared stores, glob/grep search, and Row Level…”. Read the project documentation for the complete scope.

Installation

The documented npm package is mcp-virtual-fs. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares DATABASE_URL, VFS_AUTO_INIT. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

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
readpath
writepath, content
appendpath, content
statpath
lspath
mkdirpath
rmpath
mvsource, destination
globpattern
greppattern, path_filter?
stores(none)

How to install the Virtual Filesystem MCP Server

{
  "mcpServers": {
    "virtual-fs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-virtual-fs"
      ],
      "env": {
        "DATABASE_URL": "postgresql://postgres:postgres@localhost:5432/vfs",
        "VFS_AUTO_INIT": "true"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
DATABASE_URLDeclared in the maintainer’s client configuration.Yes
VFS_AUTO_INITDeclared in the maintainer’s client configuration.Optional