MCP Internet Speed Test

by inventer-dev

14 stars
184 downloads
Not rated
GitHub

About

The MCP Internet Speed Test is a specialized Model Context Protocol (MCP) server that enables AI models and agents to perform internet speed measurements.

Details

Author
inventer-dev
GitHub stars
14
Downloads
184
Categories
Other, Developer Tools

- Smart incremental testing with configurable 8-second threshold
- Download and upload speed testing (128 KB to 128 MB)
- Latency and jitter measurement with configurable samples
- Multi-CDN detection (Fastly, Cloudflare, AWS CloudFront)
- Geographic location mapping (150+ POPs worldwide)
- Cache status analysis (HIT/MISS) and server header extraction
- Single run_complete_test function for comprehensive metrics
- Available via PyPI, uv, Docker, and local development

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Internet Speed Test
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the package from PyPI with pip install mcp-internet-speed-test or use uvx mcp-internet-speed-test. Then run mcp-internet-speed-test to start the server. Configure it in MCP clients (e.g., Claude Desktop) by adding the command and optional arguments to the MCP configuration file.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp internet speed test": {
            "internet-speed-test": {
                "command": "uvx",
                "args": [
                    "/path/to/mcp-internet-speed-test"
                ]
            }
        }
    }
}

McpServers

{
    "internet-speed-test": {
        "command": "uvx",
        "args": [
            "/path/to/mcp-internet-speed-test"
        ]
    }
}

MCP Internet Speed Test

An implementation of a Model Context Protocol (MCP) for internet speed testing. It allows AI models and agents to measure, analyze, and report network performance metrics through a standardized interface.

📦 Available on PyPI: https://pypi.org/project/mcp-internet-speed-test/

🚀 Quick Start:

pip install mcp-internet-speed-test
mcp-internet-speed-test

What is MCP?

The Model Context Protocol (MCP) provides a standardized way for Large Language Models (LLMs) to interact with external tools and data sources. Think of it as the "USB-C for AI applications" - a common interface that allows AI systems to access real-world capabilities and information.

Features

- Smart Incremental Testing: Uses SpeedOf.Me methodology with 8-second threshold for optimal accuracy
- Download Speed Testing: Measures bandwidth using files from 128KB to 128MB from GitHub repository (Git LFS)
- Upload Speed Testing: Tests upload bandwidth using streaming data from 128KB to 128MB
- Latency Testing: Measures network latency using multiple samples, reports minimum value
- Jitter Analysis: Calculates network stability using multiple latency samples (default: 5)
- Multi-CDN Support: Detects and provides info for Fastly, Cloudflare, and AWS CloudFront
- Geographic Location: Maps POP codes to physical locations (50+ locations worldwide)
- Cache Analysis: Detects HIT/MISS status and cache headers
- Server Metadata: Extracts detailed CDN headers including x-served-by, via, x-cache
- Comprehensive Testing: Single function to run all tests with complete metrics

Installation

Prerequisites

- Python 3.12 or higher (required for async support)
- pip or uv package manager

Option 1: Install from PyPI with pip (Recommended)

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.