Virtual Filesystem
PostgreSQL-backed virtual filesystem for agents: session isolation, shared stores, POSIX…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.2.2
- Listing updated
- 4 days ago
About Virtual Filesystem
Virtual Filesystem is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
PostgreSQL-backed virtual filesystem for agents: session isolation, shared stores, POSIX ops, RLS.
Install
Run in a terminal
claude mcp add virtual-fs --env DATABASE_URL='<DATABASE_URL>' -- npx -y mcp-virtual-fsAdd to claude_desktop_config.json
{
"mcpServers": {
"virtual-fs": {
"command": "npx",
"args": [
"-y",
"mcp-virtual-fs"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"virtual-fs": {
"command": "npx",
"args": [
"-y",
"mcp-virtual-fs"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"virtual-fs": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-virtual-fs"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"virtual-fs": {
"command": "npx",
"args": [
"-y",
"mcp-virtual-fs"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"virtual-fs": {
"command": "npx",
"args": [
"-y",
"mcp-virtual-fs"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Configuration
DATABASE_URLPostgreSQL connection string (e.g. postgresql://user:pass@host:5432/dbname)RequiredVFS_AUTO_INITAuto-create database tables on startup (set to 'true' for first run)VFS_SESSION_IDDeterministic session ID for resumable sessions across restartsVFS_ENABLE_RLSEnable PostgreSQL Row Level Security for database-enforced session isolation
Pricing
Open source
Virtual Filesystem FAQ
Is Virtual Filesystem free?
Yes. Virtual Filesystem is open source, so you can use and self-host it for free.
How do I add Virtual Filesystem to Claude Code?
Run this command in your terminal: claude mcp add virtual-fs --env DATABASE_URL='<DATABASE_URL>' -- npx -y mcp-virtual-fs
What are the best alternatives to Virtual Filesystem?
The closest alternatives to Virtual Filesystem are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.
Alternatives to Virtual Filesystem

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents
Invoices
MCP serverMCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files
- 4 tools
- Remote
- Paid
- Files and documents

SigPen
MCP serverMCP server that drafts e-signature documents while you approve every send
Not checked yet- 13 tools
- Remote
- Freemium
- Files and documents

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media

WhoScribe
MCP serverSearch and read your WhoScribe audio and video transcripts from ChatGPT, read-only
Not checked yet- Remote
- Freemium
- Design and media