mcp-internet-speed-test

Instructions

Run a complete speed test returning all metrics in a single call.

This test uses the smart incremental approach inspired by SpeedOf.Me:
- First measures download speed with gradually increasing file sizes
- Then measures upload speed with gradually increasing data sizes
- Measures latency and jitter
- Returns comprehensive results with real-time data

Args:
    max_size: Maximum file size to test (default: 100MB)
    url_upload: URL for upload testing
    url_latency: URL for latency testing

Returns:
    Complete test results including download, upload, latency and jitter metrics

Implementation Reference

• mcp_internet_speed_test/main.py:761-797 (handler)

  The main handler function decorated with @mcp.tool() that implements the 'run_complete_test' tool. It coordinates download speed, upload speed, latency, and jitter tests by calling the respective tool functions and returns a comprehensive result dictionary.

  @mcp.tool()
  async def run_complete_test(
      max_size: str = "100MB",
      url_upload: str = DEFAULT_UPLOAD_URL,
      url_latency: str = DEFAULT_LATENCY_URL,
  ) -> dict:
      """
      Run a complete speed test returning all metrics in a single call.
  
      This test uses the smart incremental approach inspired by SpeedOf.Me:
      - First measures download speed with gradually increasing file sizes
      - Then measures upload speed with gradually increasing data sizes
      - Measures latency and jitter
      - Returns comprehensive results with real-time data
  
      Args:
          max_size: Maximum file size to test (default: 100MB)
          url_upload: URL for upload testing
          url_latency: URL for latency testing
  
      Returns:
          Complete test results including download, upload, latency and jitter metrics
      """
      download_result = await measure_download_speed(max_size)
      upload_result = await measure_upload_speed(url_upload, max_size)
      latency_result = await measure_latency(url_latency)
      jitter_result = await measure_jitter(url_latency)
  
      return {
          "timestamp": time.time(),
          "download": download_result,
          "upload": upload_result,
          "latency": latency_result,
          "jitter": jitter_result,
          "test_methodology": "Incremental file size approach with 8-second threshold",
      }