GS Robot MCP Server

Instructions

Args:
    map_id: The ID of the target map.

Returns:
    A dictionary containing map subareas information.

Implementation Reference

• src/gs_openapi/mcp/gausium_mcp.py:231-260 (handler)

  Core handler method in GausiumMCP class that implements the tool logic by calling the Gausium API client with appropriate endpoint.

  async def get_map_subareas(self, map_id: str, robot_sn: str = None) -> Dict[str, Any]:
      """
      获取地图分区信息。
  
      Args:
          map_id: 地图ID
          robot_sn: 机器人序列号 (某些API版本需要)
  
      Returns:
          地图分区详细信息
  
      Raises:
          ValueError: map_id为空
          httpx.HTTPStatusError: API调用错误
          httpx.RequestError: 网络问题
      """
      if not map_id:
          raise ValueError("Map ID cannot be empty")
  
      # 构建请求体
      request_data = {"mapId": map_id}
      if robot_sn:
          request_data["robotSn"] = robot_sn
  
      async with GausiumAPIClient() as client:
          return await client.call_endpoint(
              'get_map_subareas',
              json_data=request_data
          )

• src/gs_openapi/main.py:106-116 (registration)

  MCP tool registration using @mcp.tool() decorator. Thin wrapper that delegates to the GausiumMCP instance method.

  @mcp.tool()
  async def get_map_subareas(map_id: str):
      """Gets map subareas information for precise area control.
  
      Args:
          map_id: The ID of the target map.
  
      Returns:
          A dictionary containing map subareas information.
      """
      return await mcp.get_map_subareas(map_id=map_id)

• src/gs_openapi/core/endpoints.py:176-182 (schema)

  API endpoint configuration defining the path, method, version, and other details used by the GausiumAPIClient to make the actual HTTP call.

  'get_map_subareas': APIEndpoint(
      name="get_map_subareas",
      path="map/subareas/get",
      method=HTTPMethod.POST,
      version=APIVersion.OPENAPI_V1,
      description="查询机器人地图分区"
  ),