chuk-mcp-vfs

Instructions

Implementation Reference

• src/chuk_mcp_vfs/server.py:63-66 (registration)

  Registers the workspace_switch tool using @server.tool decorator, delegating to workspace_tools.workspace_switch
  @server.tool async def workspace_switch(name: str): """Switch to a different workspace.""" return await workspace_tools.workspace_switch(name)
• src/chuk_mcp_vfs/workspace_tools.py:82-99 (handler)

  Main handler logic for the workspace_switch tool: calls workspace_manager.switch_workspace and constructs WorkspaceSwitchResponse
  async def workspace_switch(self, name: str) -> WorkspaceSwitchResponse: """ Switch to a different workspace. Args: name: Workspace name to switch to Returns: WorkspaceSwitchResponse with new current workspace info """ info = await self.workspace_manager.switch_workspace(name) return WorkspaceSwitchResponse( name=info.name, provider=info.provider_type, current_path=info.current_path, is_mounted=info.is_mounted, )
• src/chuk_mcp_vfs/models.py:81-88 (schema)

  Pydantic model defining the response schema for workspace_switch tool
  class WorkspaceSwitchResponse(BaseModel): """Response from workspace switch""" name: str provider: ProviderType current_path: str is_mounted: bool
• src/chuk_mcp_vfs/workspace_manager.py:269-288 (helper)

  Core helper method in WorkspaceManager that performs the actual workspace switch by updating current_namespace_id
  async def switch_workspace(self, name: str) -> WorkspaceInfo: """ Switch to a different workspace. Args: name: Workspace name Returns: WorkspaceInfo for the switched workspace Raises: ValueError: If workspace doesn't exist """ # Find namespace by name for nid, info in self._namespace_to_info.items(): if info.name == name: self._current_namespace_id = nid return info raise ValueError(f"Workspace '{name}' does not exist")