chuk-mcp-vfs

Instructions

Implementation Reference

• src/chuk_mcp_vfs/workspace_tools.py:154-182 (handler)

  Core handler function that executes the unmount logic: checks mount status, updates workspace info (sets is_mounted=False), and returns response. Note: FUSE unmount is TODO.

  async def workspace_unmount(
      self, name: str | None = None
  ) -> WorkspaceUnmountResponse:
      """
      Unmount workspace.
  
      Args:
          name: Workspace name (None for current)
  
      Returns:
          WorkspaceUnmountResponse with success status
      """
      info = self.workspace_manager.get_workspace_info(name)
  
      if not info.is_mounted:
          return WorkspaceUnmountResponse(
              success=False,
              workspace=info.name,
              error=f"Workspace '{info.name}' is not mounted",
          )
  
      # TODO: Implement FUSE unmounting
      info.is_mounted = False
      mount_point = info.mount_point
      info.mount_point = None
  
      return WorkspaceUnmountResponse(
          success=True, workspace=info.name, mount_point=mount_point
      )

• src/chuk_mcp_vfs/server.py:78-81 (registration)

  MCP tool registration using @server.tool decorator. This is the entry point handler that delegates to the underlying workspace_tools implementation.

  @server.tool
  async def workspace_unmount(name: str | None = None):
      """Unmount workspace."""
      return await workspace_tools.workspace_unmount(name)

• src/chuk_mcp_vfs/models.py:106-112 (schema)

  Pydantic BaseModel defining the output schema for the workspace_unmount tool response.

  class WorkspaceUnmountResponse(BaseModel):
      """Response from workspace unmount"""
  
      success: bool
      workspace: str
      mount_point: str | None = None
      error: str | None = None