chuk-mcp-vfs

Instructions

Implementation Reference

• src/chuk_mcp_vfs/checkpoint_tools.py:47-65 (handler)

  Core handler method in CheckpointTools class that restores the workspace from a given checkpoint_id by delegating to CheckpointManager.

  async def checkpoint_restore(
      self, request: CheckpointRestoreRequest
  ) -> CheckpointRestoreResponse:
      """
      Restore workspace to a checkpoint.
  
      Args:
          request: CheckpointRestoreRequest with checkpoint_id
  
      Returns:
          CheckpointRestoreResponse with success status
      """
      await self.checkpoint_manager.restore_checkpoint(request.checkpoint_id)
  
      return CheckpointRestoreResponse(
          success=True,
          checkpoint_id=request.checkpoint_id,
          restored_at=datetime.now(UTC),
      )

• src/chuk_mcp_vfs/server.py:160-163 (registration)

  MCP tool registration using @server.tool decorator, which delegates to the CheckpointTools instance.

  @server.tool
  async def checkpoint_restore(request: CheckpointRestoreRequest):
      """Restore workspace to a checkpoint."""
      return await checkpoint_tools_instance.checkpoint_restore(request)

• src/chuk_mcp_vfs/models.py:304-308 (schema)

  Pydantic model defining the input schema for the checkpoint_restore tool.

  class CheckpointRestoreRequest(BaseModel):
      """Request to restore checkpoint"""
  
      checkpoint_id: str

• src/chuk_mcp_vfs/models.py:310-316 (schema)

  Pydantic model defining the output schema for the checkpoint_restore tool.

  class CheckpointRestoreResponse(BaseModel):
      """Response from checkpoint restore"""
  
      success: bool
      checkpoint_id: str
      restored_at: datetime