GS Robot MCP Server

Instructions

Based on: https://developer.gs-robot.com/zh_CN/Robot%20Information%20Service/List%20Robots

Args:
    page: The page number to retrieve (must be > 0).
    page_size: The number of items per page.
    relation: Optional relation type (e.g., 'contract').

Returns:
    A dictionary containing the robot list data from the API.

Implementation Reference

• src/gs_openapi/main.py:31-46 (handler)

  MCP tool handler for 'list_robots', registered via @mcp.tool() decorator. Executes the tool logic by calling the underlying mcp.list_robots method.

  @mcp.tool()
  async def list_robots(page: int = 1, page_size: int = 10, relation: str = None):
      """Fetches the list of robots from the Gausium OpenAPI.
      
      Based on: https://developer.gs-robot.com/zh_CN/Robot%20Information%20Service/List%20Robots
  
      Args:
          page: The page number to retrieve (must be > 0).
          page_size: The number of items per page.
          relation: Optional relation type (e.g., 'contract').
  
      Returns:
          A dictionary containing the robot list data from the API.
      """
      return await mcp.list_robots(page=page, page_size=page_size, relation=relation)

• src/gs_openapi/mcp/gausium_mcp.py:31-64 (helper)

  Core helper method in GausiumMCP class implementing the logic to list robots by calling the Gausium API endpoint via GausiumAPIClient.

  async def list_robots(
      self,
      page: int = 1,
      page_size: int = 10,
      relation: Optional[str] = None
  ) -> Dict[str, Any]:
      """
      获取机器人列表。
  
      Args:
          page: 页码 (必须 > 0)
          page_size: 每页数量
          relation: 可选关系类型 (例如 'contract')
  
      Returns:
          包含机器人列表数据的字典
  
      Raises:
          httpx.HTTPStatusError: API调用返回错误状态码
          httpx.RequestError: 网络连接问题
      """
      query_params = {
          "page": page,
          "pageSize": page_size,
      }
      if relation is not None:
          query_params["relation"] = relation
  
      async with GausiumAPIClient() as client:
          return await client.call_endpoint(
              'list_robots',
              query_params=query_params
          )

• src/gs_openapi/core/endpoints.py:73-79 (schema)

  API endpoint configuration definition for 'list_robots', specifying path, method, version, used by the API client for HTTP requests.

  'list_robots': APIEndpoint(
      name="list_robots",
      path="robots",
      method=HTTPMethod.GET,
      version=APIVersion.V1_ALPHA1,
      description="列出机器人"
  ),

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

  The @mcp.tool() decorator registers the list_robots function as an MCP tool.

  @mcp.tool()