chuk-mcp-vfs

Instructions

Implementation Reference

• src/chuk_mcp_vfs/server.py:58-62 (registration)

  MCP server registration of the 'workspace_list' tool, which delegates to WorkspaceTools.workspace_list()

  @server.tool
  async def workspace_list():
      """List all workspaces."""
      return await workspace_tools.workspace_list()

• src/chuk_mcp_vfs/workspace_tools.py:69-80 (handler)

  Core handler logic for listing workspaces: syncs namespaces and returns list via WorkspaceListResponse

  async def workspace_list(self) -> WorkspaceListResponse:
      """
      List all workspaces.
  
      Returns:
          WorkspaceListResponse with list of workspaces
      """
      # Sync with namespaces first
      await self.workspace_manager._sync_namespaces()
      workspaces = self.workspace_manager.list_workspaces()
  
      return WorkspaceListResponse(workspaces=workspaces)

• src/chuk_mcp_vfs/models.py:75-79 (schema)

  Pydantic schema for the response: contains list of WorkspaceInfo objects

  class WorkspaceListResponse(BaseModel):
      """Response from workspace list"""
  
      workspaces: list[WorkspaceInfo]

• src/chuk_mcp_vfs/models.py:34-45 (schema)

  Pydantic schema for individual workspace information used in the list response

  class WorkspaceInfo(BaseModel):
      """Information about a workspace"""
  
      name: str
      provider_type: ProviderType
      created_at: datetime
      current_path: str = "/"
      mount_point: str | None = None
      is_mounted: bool = False
      metadata: dict[str, Any] = Field(default_factory=dict)
  
      model_config = {"use_enum_values": False}