chuk-mcp-vfs

Instructions

Implementation Reference

• src/chuk_mcp_vfs/checkpoint_tools.py:25-46 (handler)

  The core handler function in CheckpointTools class that executes the checkpoint creation logic by calling the checkpoint_manager and constructing the response.

  async def checkpoint_create(
      self, request: CheckpointCreateRequest
  ) -> CheckpointCreateResponse:
      """
      Create a checkpoint of the current workspace state.
  
      Args:
          request: CheckpointCreateRequest with name and description
  
      Returns:
          CheckpointCreateResponse with checkpoint info
      """
      checkpoint_info = await self.checkpoint_manager.create_checkpoint(
          name=request.name, description=request.description
      )
  
      return CheckpointCreateResponse(
          success=True,
          checkpoint_id=checkpoint_info.id,
          created_at=checkpoint_info.created_at,
      )

• src/chuk_mcp_vfs/server.py:155-158 (registration)

  MCP server tool registration using @server.tool decorator, which proxies the call to the CheckpointTools instance's checkpoint_create method.

  @server.tool
  async def checkpoint_create(request: CheckpointCreateRequest):
      """Create a checkpoint of the current workspace state."""
      return await checkpoint_tools_instance.checkpoint_create(request)

• src/chuk_mcp_vfs/models.py:289-302 (schema)

  Pydantic schema definitions for the input CheckpointCreateRequest and output CheckpointCreateResponse models used by the tool.

  class CheckpointCreateRequest(BaseModel):
      """Request to create checkpoint"""
  
      name: str | None = None
      description: str = ""
  
  
  class CheckpointCreateResponse(BaseModel):
      """Response from checkpoint creation"""
  
      success: bool
      checkpoint_id: str
      created_at: datetime