chuk-mcp-vfs

Instructions

Implementation Reference

• src/chuk_mcp_vfs/checkpoint_tools.py:67-76 (handler)

  Core handler function that executes the checkpoint_list tool logic by listing checkpoints from the manager and returning a Pydantic response model.
  async def checkpoint_list(self) -> CheckpointListResponse: """ List all checkpoints for the current workspace. Returns: CheckpointListResponse with list of checkpoints """ checkpoints = await self.checkpoint_manager.list_checkpoints() return CheckpointListResponse(checkpoints=checkpoints)
• src/chuk_mcp_vfs/server.py:165-168 (registration)

  Registers the checkpoint_list tool with the MCP server using the @server.tool decorator, delegating execution to the CheckpointTools instance.
  @server.tool async def checkpoint_list(): """List all checkpoints for the current workspace.""" return await checkpoint_tools_instance.checkpoint_list()
• src/chuk_mcp_vfs/models.py:318-322 (schema)

  Pydantic BaseModel defining the output schema for the checkpoint_list tool, containing a list of CheckpointInfo objects.
  class CheckpointListResponse(BaseModel): """Response from checkpoint list""" checkpoints: list[CheckpointInfo]
• src/chuk_mcp_vfs/models.py:277-287 (schema)

  Pydantic model for individual checkpoint information, used within CheckpointListResponse.
  class CheckpointInfo(BaseModel): """Information about a checkpoint""" id: str name: str | None = None description: str created_at: datetime workspace: str provider_type: ProviderType stats: dict[str, Any] = Field(default_factory=dict)