RSpace MCP Server

Instructions

Implementation Reference

• main.py:1023-1051 (handler)

  The handler function for the 'move_items_to_grid_container_by_column' tool. It is decorated with @mcp.tool which also serves as the registration. The function moves specified items to a grid container, filling it column by column starting from the given position, auto-detecting dimensions if needed, and returns success status and results.

  @mcp.tool(tags={"rspace", "inventory", "movement"})
  def move_items_to_grid_container_by_column(
      target_container_id: Union[int, str],
      item_ids: List[str],
      start_column: int = 1,
      start_row: int = 1,
      total_columns: int = None,
      total_rows: int = None
  ) -> dict:
      """
      Moves items to grid container, filling positions column by column
      
      Usage: Alternative filling pattern for specific experimental layouts
      Auto-positioning: Fills down columns before moving to next column
      Returns: Success status and final positions of moved items
      """
      # Auto-detect container dimensions if not provided
      if total_columns is None or total_rows is None:
          container = inv_cli.get_container_by_id(target_container_id)
          container_obj = i.Container.of(container)
          if hasattr(container_obj, 'column_count'):
              total_columns = container_obj.column_count()
              total_rows = container_obj.row_count()
          else:
              raise ValueError("Container dimensions required for non-grid containers")
      
      placement = i.ByColumn(start_column, start_row, total_columns, total_rows, *item_ids)
      result = inv_cli.add_items_to_grid_container(target_container_id, placement)
      return {"success": result.is_ok(), "results": result.data if hasattr(result, 'data') else str(result)}