chuk-mcp-vfs

Instructions

Implementation Reference

• src/chuk_mcp_vfs/workspace_tools.py:113-152 (handler)

  The primary handler function executing the workspace_mount tool logic, including mount point validation and placeholder FUSE mounting.

  async def workspace_mount(
      self, request: WorkspaceMountRequest
  ) -> WorkspaceMountResponse:
      """
      Mount workspace via FUSE.
  
      Args:
          request: WorkspaceMountRequest with name and optional mount_point
  
      Returns:
          WorkspaceMountResponse with mount info
  
      Note:
          Requires FUSE support to be installed (pyfuse3 or winfspy)
      """
      info = self.workspace_manager.get_workspace_info(request.name)
  
      if info.is_mounted:
          return WorkspaceMountResponse(
              success=False,
              workspace=info.name,
              mount_point=info.mount_point,
              error=f"Workspace '{info.name}' is already mounted at {info.mount_point}",
          )
  
      mount_point = request.mount_point
      if mount_point is None:
          mount_point = f"/tmp/vfs-mounts/{info.name}"
  
      # TODO: Implement FUSE mounting
      # For now, just update the info
      info.mount_point = mount_point
      info.is_mounted = True
  
      return WorkspaceMountResponse(
          success=True,
          workspace=info.name,
          mount_point=mount_point,
          error="FUSE mounting not yet implemented - placeholder only",
      )

• src/chuk_mcp_vfs/models.py:90-104 (schema)

  Pydantic models defining input (WorkspaceMountRequest) and output (WorkspaceMountResponse) schemas for the workspace_mount tool.

  class WorkspaceMountRequest(BaseModel):
      """Request to mount workspace"""
  
      name: str | None = None
      mount_point: str | None = None
  
  
  class WorkspaceMountResponse(BaseModel):
      """Response from workspace mount"""
  
      success: bool
      workspace: str
      mount_point: str | None = None
      error: str | None = None

• src/chuk_mcp_vfs/server.py:74-77 (registration)

  MCP tool registration for 'workspace_mount', wrapping and delegating to the handler in WorkspaceTools.

  async def workspace_mount(request: WorkspaceMountRequest):
      """Mount workspace via FUSE."""
      return await workspace_tools.workspace_mount(request)