What is Mcp Internet Speed Test

The MCP Internet Speed Test is a specialized Model Context Protocol (MCP) server designed for measuring internet speed. It enables AI models and agents to perform network performance assessments through a standardized interface.

Use cases

Use cases include testing internet speed for AI applications, optimizing network performance for remote work, and providing real-time network diagnostics for users.

How to use

To use the MCP Internet Speed Test, you can run it directly using the uvx command or through Docker. Ensure you have Python 3.12 or higher and the required dependencies installed. Configure your MCP client to include the server in its configuration file.

Key features

Key features include download speed testing, upload speed testing with configurable file sizes, latency testing to various servers, jitter analysis, and comprehensive JSON-formatted reporting.

Where to use

The MCP Internet Speed Test can be utilized in various fields such as network performance analysis, AI model training and evaluation, and any application requiring internet speed metrics.

MCP Internet Speed Test

⚠️ Experimental Version

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

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

• Download Speed Testing: Measure download bandwidth
• Upload Speed Testing: Measure upload bandwidth with configurable file sizes
• Latency Testing: Measure network latency to various servers
• Jitter Analysis: Calculate network jitter by analyzing latency variations
• Comprehensive Reporting: Provide detailed JSON-formatted reports

Installation

Prerequisites

• Python 3.12 or higher
• uv package manager (recommended)

Option 1: Using uvx (Recommended)

The uvx command is a convenient way to run Python packages directly without explicit installation:

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

Option 2: Using 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

Configuration

To use this MCP server with Claude Desktop or other MCP clients, add it to your MCP configuration file.

Claude Desktop Configuration

Edit your Claude Desktop MCP configuration file:

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

API Tools

The MCP Internet Speed Test provides the following tools:

1. measure_download_speed: Measures download bandwidth (in Mbps)
2. measure_upload_speed: Measures upload bandwidth (in Mbps)
3. measure_latency: Measures network latency (in ms)
4. measure_jitter: Measures network jitter by analyzing latency variations
5. run_complete_test: Runs all tests and provides a comprehensive report

Troubleshooting

If you’re having issues connecting to the MCP server:

1. Make sure the path in your MCP configuration is correct
2. Check that you have the required permissions for the directory
3. Verify Python 3.12+ is installed and in your PATH
4. Ensure the mcp[cli] and httpx packages are installed

Development

This is an experimental project and contributions are welcome. To contribute:

1. Open an issue or submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• MCP Framework maintainers for standardizing AI tool interactions
• The Model Context Protocol community for documentation and examples