GS Robot MCP Server

Instructions

Args:
    map_id: The ID of the map to download.

Returns:
    A dictionary containing the map download information.

Implementation Reference

• src/gs_openapi/mcp/gausium_mcp.py:561-583 (handler)

  Core handler implementation for the download_robot_map_v2 tool. Validates input and uses GausiumAPIClient to call the V2 map download API endpoint.

  async def download_robot_map_v2(self, map_id: str) -> Dict[str, Any]:
      """
      V2地图下载。
  
      Args:
          map_id: 地图ID
  
      Returns:
          地图下载信息
  
      Raises:
          ValueError: map_id为空
          httpx.HTTPStatusError: API调用错误
          httpx.RequestError: 网络问题
      """
      if not map_id:
          raise ValueError("Map ID cannot be empty")
  
      async with GausiumAPIClient() as client:
          return await client.call_endpoint(
              'download_map_v2',
              path_params={'map_id': map_id}
          )

• src/gs_openapi/main.py:210-220 (registration)

  MCP tool registration and thin wrapper handler that delegates to the GausiumMCP class method.

  @mcp.tool()
  async def download_robot_map_v2(map_id: str):
      """Downloads a robot map using V2 API.
  
      Args:
          map_id: The ID of the map to download.
  
      Returns:
          A dictionary containing the map download information.
      """
      return await mcp.download_robot_map_v2(map_id=map_id)

• src/gs_openapi/core/endpoints.py:204-210 (schema)

  API endpoint configuration/schema used by the GausiumAPIClient for the download_map_v2 call.

  'download_map_v2': APIEndpoint(
      name="download_robot_map_v2",
      path="map/{map_id}/download",
      method=HTTPMethod.GET,
      version=APIVersion.OPENAPI_V2_ALPHA1,
      description="V2地图下载"
  )