perfsonar-mcp

Instructions

Implementation Reference

• src/perfsonar_mcp/fastmcp_server.py:242-259 (handler)

  The 'lookup_testpoints' tool is defined as an @mcp.tool() in fastmcp_server.py. It uses the 'lookup_client' to fetch testpoints and serializes the result to JSON.

  @mcp.tool()
  async def lookup_testpoints(
      serviceType: Optional[str] = None,
      locationCity: Optional[str] = None,
      locationCountry: Optional[str] = None,
  ) -> str:
      """Find perfSONAR testpoints using the lookup service.
  
      Args:
          serviceType: Service type filter (e.g., 'bwctl', 'owamp')
          locationCity: City filter (e.g., 'Chicago', 'London')
          locationCountry: Country filter (e.g., 'US', 'GB')
  
      Returns:
          JSON string with list of matching testpoints
      """
      results = await lookup_client.find_testpoints(serviceType, locationCity, locationCountry)
      return json.dumps([r.model_dump(by_alias=True) for r in results], indent=2)