Skip to main content
Glama
mcp-internet-speed-test

mcp-internet-speed-test

MCP Internet-Geschwindigkeitstest

⚠️ Experimentelle Version

Dies ist eine experimentelle Implementierung eines Model Context Protocol (MCP)-Servers für Internetgeschwindigkeitstests. Sie ermöglicht KI-Modellen und Agenten, Netzwerkleistungsmetriken über eine standardisierte Schnittstelle zu messen, zu analysieren und zu melden.

Related MCP server: Test MCP Feb4 MCP Server

Was ist MCP?

Das Model Context Protocol (MCP) bietet Large Language Models (LLMs) eine standardisierte Möglichkeit, mit externen Tools und Datenquellen zu interagieren. Stellen Sie es sich als „USB-C für KI-Anwendungen“ vor – eine gemeinsame Schnittstelle, die KI-Systemen den Zugriff auf reale Funktionen und Informationen ermöglicht.

Merkmale

  • Download-Geschwindigkeitstest : Download-Bandbreite messen

  • Upload-Geschwindigkeitstest : Messen Sie die Upload-Bandbreite mit konfigurierbaren Dateigrößen

  • Latenztests : Messen Sie die Netzwerklatenz zu verschiedenen Servern

  • Jitter-Analyse : Berechnen Sie Netzwerk-Jitter durch die Analyse von Latenzschwankungen

  • Umfassende Berichterstattung : Bereitstellung detaillierter Berichte im JSON-Format

Installation

Voraussetzungen

  • Python 3.12 oder höher

  • UV -Paketmanager (empfohlen)

Option 1: Verwendung von uvx (empfohlen)

Der Befehl uvx ist eine bequeme Möglichkeit, Python-Pakete direkt auszuführen, ohne sie explizit zu installieren:

# Run the MCP server directly
uvx /path/to/mcp-internet-speed-test

Option 2: Verwenden von Docker

# Build the Docker image
docker build -t mcp-internet-speed-test .

# Run the MCP server in a Docker container
docker run -it --rm -v $(pwd):/app -w /app mcp-internet-speed-test

Konfiguration

Um diesen MCP-Server mit Claude Desktop oder anderen MCP-Clients zu verwenden, fügen Sie ihn Ihrer MCP-Konfigurationsdatei hinzu.

Claude Desktop-Konfiguration

Bearbeiten Sie Ihre Claude Desktop MCP-Konfigurationsdatei:

{
    "mcpServers": {
        "mcp-internet-speed-test": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/mcp-internet-speed-test",
                "run",
                "main.py"
            ]
        }
    }
}

API-Tools

Der MCP Internet Speed Test bietet die folgenden Tools:

  1. measure_download_speed : Misst die Download-Bandbreite (in Mbit/s)

  2. measure_upload_speed : Misst die Upload-Bandbreite (in Mbit/s)

  3. measure_latency : Misst die Netzwerklatenz (in ms)

  4. measure_jitter : Misst Netzwerk-Jitter durch Analyse von Latenzschwankungen

  5. run_complete_test : Führt alle Tests aus und erstellt einen umfassenden Bericht

Fehlerbehebung

Wenn Sie Probleme beim Herstellen einer Verbindung zum MCP-Server haben:

  1. Stellen Sie sicher, dass der Pfad in Ihrer MCP-Konfiguration korrekt ist

  2. Überprüfen Sie, ob Sie über die erforderlichen Berechtigungen für das Verzeichnis verfügen

  3. Überprüfen Sie, ob Python 3.12+ installiert ist und sich in Ihrem PATH befindet

  4. Stellen Sie sicher, dass die Pakete mcp[cli] und httpx installiert sind

Entwicklung

Dies ist ein experimentelles Projekt. Beiträge sind willkommen. So können Sie mitmachen:

  1. Öffnen Sie ein Problem oder senden Sie eine Pull-Anfrage

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.

Danksagung

  • MCP-Framework-Betreuer zur Standardisierung von KI-Tool-Interaktionen

  • Die Model Context Protocol-Community für Dokumentation und Beispiele

Available Tools

6 tools
get_server_infoA
Get server information for any URL without performing speed tests.

Args:
    url_download: URL to download data from
    url_upload: URL to upload data to
    url_latency: URL to measure latency to

Returns:
    Dictionary with servers information including POP location, CDN info, etc.

Inputs: url_download, url_upload, url_latency.

measure_download_speedB
Measure download speed using incremental file sizes.

Args:
    size_limit: Maximum file size to test (default: 128MB)
    sustain_time: Duration in seconds for each test (1-8, default: 8)

Returns:
    Dictionary with download speed results

Inputs: size_limit, sustain_time.

measure_jitterD

Jitter is the variation in latency, so we need multiple measurements.

Inputs: url, samples.

measure_latencyB

Measure the latency using multiple samples and report the minimum.

Takes a number of samples and reports the lowest
value for the most accurate representation of network latency.

Args:
    url (str): The URL to measure latency to
    samples (int): Number of samples to take (default: 10)

Returns:
    Dictionary with latency result (minimum of all samples)

Inputs: url, samples.

measure_upload_speedB
Measure upload speed using incremental file sizes.

Args:
    url_upload: URL to upload data to
    size_limit: Maximum file size to test (default: 128MB)
    sustain_time: Duration in seconds for each test (1-8, default: 8)

Returns:
    Dictionary with upload speed results

Inputs: url_upload, size_limit, sustain_time.

run_complete_testA
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: 128MB)
    url_upload: URL for upload testing
    url_latency: URL for latency testing
    sustain_time: Duration in seconds for each test (1-8, default: 8)

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

Inputs: max_size, url_upload, url_latency, sustain_time.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: server info, download speed, jitter, latency, upload speed, and a combined test. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern (get_, measure_, run_). Even though 'measure' appears multiple times, the nouns are distinct.

    Tool Count5/5

    6 tools is ideal for an internet speed test server, covering all key metrics plus a combined test and server info without bloat.

    Completeness5/5

    The set covers all standard speed test metrics: download, upload, latency, jitter, and server info. A combined test is also provided. No obvious gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that allows users to ping other hosts to check network connectivity and diagnostic information. It enables LLMs to perform network latency tests and host availability checks through a standardized interface.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides standardized tools for AI agents to interact with the Test MCP Feb4 API. It enables LLMs to access API endpoints through asynchronous operations and standardized Model Context Protocol tools.
      -