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:537-560 (handler)

  Core handler implementation that validates input and calls the V1 map download API endpoint via GausiumAPIClient.

  async def download_robot_map_v1(self, map_id: str) -> Dict[str, Any]:
      """
      V1获取地图下载。
  
      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_v1',
              path_params={'map_id': map_id}
          )

• src/gs_openapi/main.py:198-208 (registration)

  MCP tool registration with @mcp.tool() decorator, providing the entry point that delegates to the GausiumMCP instance.

  @mcp.tool()
  async def download_robot_map_v1(map_id: str):
      """Downloads a robot map using V1 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_v1(map_id=map_id)

• src/gs_openapi/core/endpoints.py:197-203 (registration)

  API endpoint configuration defining the path, method, version, and description for the download_robot_map_v1 tool.

  'download_map_v1': APIEndpoint(
      name="download_robot_map_v1",
      path="map/{map_id}/download",
      method=HTTPMethod.GET,
      version=APIVersion.OPENAPI_V1,
      description="V1获取地图下载"
  ),