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

mcp-internet-speed-test

MCPインターネット速度テスト

⚠️ 実験版

これは、インターネット速度テスト用のモデルコンテキストプロトコル(MCP)サーバーの実験的な実装です。AIモデルとエージェントは、標準化されたインターフェースを通じてネットワークパフォーマンス指標を測定、分析、レポートできます。

Related MCP server: Test MCP Feb4 MCP Server

MCPとは何ですか?

モデルコンテキストプロトコル(MCP)は、大規模言語モデル(LLM)が外部ツールやデータソースと連携するための標準化された方法を提供します。これは「AIアプリケーション用のUSB-C」とも言えるもので、AIシステムが現実世界の機能や情報にアクセスできるようにする共通インターフェースです。

特徴

  • ダウンロード速度テスト:ダウンロード帯域幅を測定

  • アップロード速度テスト: 設定可能なファイルサイズでアップロード帯域幅を測定

  • レイテンシテスト: さまざまなサーバーへのネットワークレイテンシを測定します

  • ジッター分析: レイテンシの変動を分析してネットワークジッターを計算します

  • 包括的なレポート:詳細なJSON形式のレポートを提供します

インストール

前提条件

  • Python 3.12以上

  • uvパッケージ マネージャー (推奨)

オプション1: uvxの使用(推奨)

uvxコマンドは、明示的なインストールなしで Python パッケージを直接実行する便利な方法です。

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

オプション2: 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

構成

この MCP サーバーを Claude Desktop またはその他の MCP クライアントで使用するには、MCP 構成ファイルに追加します。

クロードデスクトップ構成

Claude Desktop MCP 構成ファイルを編集します。

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

APIツール

MCP インターネット速度テストでは、次のツールが提供されます。

  1. measure_download_speed : ダウンロード帯域幅を測定します(Mbps単位)

  2. measure_upload_speed : アップロード帯域幅を測定します(Mbps単位)

  3. measure_latency : ネットワーク遅延を測定します(ミリ秒単位)

  4. measure_jitter : レイテンシの変化を分析してネットワークジッターを測定します

  5. run_complete_test : すべてのテストを実行し、包括的なレポートを提供します

トラブルシューティング

MCP サーバーへの接続に問題がある場合:

  1. MCP構成のパスが正しいことを確認してください

  2. ディレクトリに必要な権限があることを確認してください

  3. Python 3.12以降がインストールされ、PATHに含まれていることを確認します。

  4. mcp[cli]およびrequestsパッケージがインストールされていることを確認する

発達

これは実験的なプロジェクトであり、貢献を歓迎します。貢献するには:

  1. 問題を開くか、プルリクエストを送信する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

謝辞

  • AIツールのインタラクションを標準化するMCPフレームワークのメンテナー

  • ドキュメントと例のためのモデルコンテキストプロトコルコミュニティ

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.
      -