chuk-mcp-vfs

Instructions

Implementation Reference

• src/chuk_mcp_vfs/vfs_tools.py:69-99 (handler)

  VFSTools.write: the core handler implementing file write logic, resolving path, creating parents, encoding content, and writing to VFS.
  async def write(self, request: WriteRequest) -> WriteResponse: """ Write content to file. Args: request: WriteRequest with path and content Returns: WriteResponse with success status """ from pathlib import PurePosixPath vfs = self.workspace_manager.get_current_vfs() resolved_path = self.workspace_manager.resolve_path(request.path) # Ensure all parent directories exist # Use PurePosixPath to ensure forward slashes on all platforms parent = str(PurePosixPath(resolved_path).parent) if parent != "/": # Create all parent directories if they don't exist parts = [p for p in parent.split("/") if p] current_path = "" for part in parts: current_path += f"/{part}" if not await vfs.exists(current_path): await vfs.mkdir(current_path) content_bytes = request.content.encode("utf-8") await vfs.write_file(resolved_path, content_bytes) return WriteResponse(success=True, path=resolved_path, size=len(content_bytes))
• src/chuk_mcp_vfs/models.py:138-151 (schema)

  Pydantic models: WriteRequest (path, content) and WriteResponse (success, path, size).
  class WriteRequest(BaseModel): """Request to write a file""" path: str content: str class WriteResponse(BaseModel): """Response from write operation""" success: bool path: str size: int
• src/chuk_mcp_vfs/server.py:92-95 (registration)

  MCP server tool registration for 'write', delegating to VFSTools instance.
  @server.tool async def write(request: WriteRequest): """Write content to file.""" return await vfs_tools.write(request)
• src/chuk_mcp_vfs/server.py:38-39 (registration)

  Instantiation of VFSTools instance used by all VFS tools including write.
  vfs_tools = VFSTools(workspace_manager) checkpoint_tools_instance = CheckpointTools(checkpoint_manager)