{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_gyapcjzpg793","handle":"chuk-mcp-vfs","url":"https://wellknown.network/agents/chuk-mcp-vfs","links":{"self":"https://wellknown.network/agents/chuk-mcp-vfs/record.json","html":"https://wellknown.network/agents/chuk-mcp-vfs","markdown":"https://wellknown.network/agents/chuk-mcp-vfs/record.md","api":"https://wellknown.network/api/v1/agents/chuk-mcp-vfs","status":"https://wellknown.network/api/v1/agents/chuk-mcp-vfs/status","claim":"https://wellknown.network/agents/chuk-mcp-vfs/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/chuk-mcp-vfs/claim.json","badge":"https://wellknown.network/agents/chuk-mcp-vfs/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/chuk-mcp-vfs/history","tools":"https://wellknown.network/api/v1/agents/chuk-mcp-vfs/tools"},"ard":{"identifier":"urn:air::server:chuk-mcp-vfs","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"chuk-mcp-vfs","summary":"MCP server for virtual filesystem workspaces with checkpoints and FUSE mounting","description":"# chuk-mcp-vfs\n\n**MCP server providing virtual filesystem workspaces via the unified namespace architecture.**\n\n## Features\n\n✅ **Unified Architecture** - Built on chuk-artifacts namespace system\n✅ **Context-Aware** - Automatic user/session scoping from MCP context\n✅ **Storage Scopes** - SESSION (ephemeral), USER (persistent), SANDBOX (shared)\n✅ **Pydantic Native** - All requests and responses use Pydantic models\n✅ **Async Native** - Fully async/await throughout\n✅ **Type Safe** - Enums and constants instead of magic strings\n✅ **Multiple Workspaces** - Create and manage isolated virtual filesystems\n✅ **Full VFS Operations** - read, write, ls, tree, mkdir, rm, mv, cp, cd, pwd, find, grep\n✅ **Checkpoints** - Save and restore filesystem state at any point\n✅ **MCP Integration** - Expose all operations as MCP tools for AI agents\n\n## Architecture\n\n```\nchuk-mcp-vfs           → Workspace management + VFS tools\n    ↓ uses\nchuk-artifacts         → Unified namespace architecture\n    ↓ manages\nNamespaces (WORKSPACE) → Each workspace is a namespace\n    ↓ provides\nchuk-virtual-fs        → Async VFS with multiple storage providers\n    ↓\nStorage Provider       → memory, filesystem, sqlite, s3\n```\n\n**Key Concepts:**\n- **Everything is VFS**: Both blobs and workspaces are VFS-backed via namespaces\n- **Scopes**: SESSION (per-conversation), USER (per-user persistent), SANDBOX (shared)\n- **Context-Aware**: user_id and session_id automatically from MCP server context\n- **Grid Architecture**: All namespaces stored in unified grid structure\n\n## Installation\n\n```bash\n# Basic installation\npip install chuk-mcp-vfs\n\n# With FUSE mounting support (Linux/macOS)\npip install chuk-mcp-vfs[mount]\n\n# Development\npip install -e .[dev]\n```\n\n## Quick Start\n\n### Running the MCP Server\n\nThe server supports two transport modes:\n\n#### 1. STDIO Transport (for Claude Desktop)\n\n```bash\n# Default - runs with stdio transport\nchuk-mcp-vfs\n\n# Explicitly specify stdio transport\nchuk-mcp-vfs --transport stdio\n\n# With d…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp","filesystem","virtual","sandbox","workspace","checkpoint"],"pricing":null,"endpoints":[{"url":"pypi:chuk-mcp-vfs","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"code.execution","name":"Code Execution","confidence":1,"provenance":"declared"},{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"declared"}],"categories":["code","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"chuk-mcp-vfs","registry":"pypi","observedAt":"2026-10-27T21:24:51.530Z","publishedAt":"2025-11-28T01:33:38.119337Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"chuk-mcp-vfs","url":"https://pypi.org/project/chuk-mcp-vfs/","firstSeenAt":"2026-09-09T11:30:34.453Z","fetchedAt":"2026-10-27T21:24:01.491Z","normalizedAt":"2026-10-27T21:24:01.491Z"}]},"firstSeenAt":"2026-09-09T11:30:34.453Z","updatedAt":"2026-10-27T21:24:51.530Z"}