chuk-mcp-vfs

# chuk-mcp-vfs **MCP server providing virtual filesystem workspaces via the unified namespace architecture.** ## Features ✅ **Unified Architecture** - Built on chuk-artifacts namespace system ✅ **Context-Aware** - Automatic user/session scoping from MCP context ✅ **Storage Scopes** - SESSION (ephemeral), USER (persistent), SANDBOX (shared) ✅ **Pydantic Native** - All requests and responses use Pydantic models ✅ **Async Native** - Fully async/await throughout ✅ **Type Safe** - Enums and constants instead of magic strings ✅ **Multiple Workspaces** - Create and manage isolated virtual filesystems ✅ **Full VFS Operations** - read, write, ls, tree, mkdir, rm, mv, cp, cd, pwd, find, grep ✅ **Checkpoints** - Save and restore filesystem state at any point ✅ **MCP Integration** - Expose all operations as MCP tools for AI agents ## Architecture ``` chuk-mcp-vfs → Workspace management + VFS tools ↓ uses chuk-artifacts → Unified namespace architecture ↓ manages Namespaces (WORKSPACE) → Each workspace is a namespace ↓ provides chuk-virtual-fs → Async VFS with multiple storage providers ↓ Storage Provider → memory, filesystem, sqlite, s3 ``` **Key Concepts:** - **Everything is VFS**: Both blobs and workspaces are VFS-backed via namespaces - **Scopes**: SESSION (per-conversation), USER (per-user persistent), SANDBOX (shared) - **Context-Aware**: user_id and session_id automatically from MCP server context - **Grid Architecture**: All namespaces stored in unified grid structure ## Installation ```bash # Basic installation pip install chuk-mcp-vfs # With FUSE mounting support (Linux/macOS) pip install chuk-mcp-vfs[mount] # Development pip install -e .[dev] ``` ## Quick Start ### Running the MCP Server The server supports two transport modes: #### 1. STDIO Transport (for Claude Desktop) ```bash # Default - runs with stdio transport chuk-mcp-vfs # Explicitly specify stdio transport chuk-mcp-vfs --transport stdio # With d…