GS Robot MCP Server

Instructions

Args:
    map_data: Map data to upload.

Returns:
    A dictionary containing the upload result with record_id.

Implementation Reference

• src/gs_openapi/mcp/gausium_mcp.py:486-512 (handler)

  Core implementation of the upload_robot_map_v1 tool: validates input, creates GausiumAPIClient, and calls the 'upload_map_v1' endpoint with map_data as JSON.

  async def upload_robot_map_v1(
      self,
      map_data: Dict[str, Any]
  ) -> Dict[str, Any]:
      """
      V1地图上传。
  
      Args:
          map_data: 地图数据
  
      Returns:
          上传结果，包含record_id
  
      Raises:
          ValueError: 地图数据为空
          httpx.HTTPStatusError: API调用错误
          httpx.RequestError: 网络问题
      """
      if not map_data:
          raise ValueError("Map data cannot be empty")
  
      async with GausiumAPIClient() as client:
          return await client.call_endpoint(
              'upload_map_v1',
              json_data=map_data
          )

• src/gs_openapi/main.py:174-184 (registration)

  MCP tool registration using @mcp.tool() decorator. This is the entry point for the 'upload_robot_map_v1' tool invoked by MCP clients, delegating to GausiumMCP method.

  @mcp.tool()
  async def upload_robot_map_v1(map_data: dict):
      """Uploads a robot map using V1 API.
  
      Args:
          map_data: Map data to upload.
  
      Returns:
          A dictionary containing the upload result with record_id.
      """
      return await mcp.upload_robot_map_v1(map_data=map_data)

• src/gs_openapi/core/endpoints.py:183-189 (schema)

  API endpoint schema/configuration for 'upload_map_v1' (named 'upload_robot_map_v1'), defining path, method, version used by GausiumAPIClient.call_endpoint.

  'upload_map_v1': APIEndpoint(
      name="upload_robot_map_v1",
      path="map/upload",
      method=HTTPMethod.POST,
      version=APIVersion.OPENAPI_V1,
      description="V1地图上传"
  ),