Internet Speed Test

🚀 MCP Internet Speed Test Server

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

🚀 Quick Start

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

✨ Features

• Download Speed Test: Measure download bandwidth.
• Upload Speed Test: Test upload bandwidth by configuring the file size.
• Latency Test: Measure network latency to different servers.
• Jitter Analysis: Calculate network jitter by analyzing latency fluctuations.
• Comprehensive Report: Provide a detailed report in JSON format.

📦 Installation Guide

Prerequisites

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

Option 1: Using uvx (Recommended)

The uvx command is a convenient way to directly run Python packages 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 using a Docker container
docker run -it --rm -v $(pwd):/app -w /app mcp-internet-speed-test

📚 Documentation

What is MCP?

The Model Context Protocol (MCP) provides a standard way for large language models (LLMs) to interact with external tools and data sources. It can be seen as the “USB - C for AI applications” — a universal interface that enables AI systems to access real - world functions and information.

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": "uvx",
            "args": [
                "/ABSOLUTE/PATH/TO/mcp-internet-speed-test"
            ]
        }
    }
}

API Tools

The MCP Internet Speed Test Server provides the following tools:

1. measure_download_speed: Measure download bandwidth (in Mbps).
2. measure_upload_speed: Test upload bandwidth by configuring the file size.
3. measure_latency: Measure network latency (in ms).
4. measure_jitter: Analyze latency fluctuations to calculate network jitter.
5. run_complete_test: Run all tests and generate a comprehensive report.

Troubleshooting

If you encounter issues connecting to the MCP server:

1. Ensure that the paths in the configuration file are correct.
2. Check that directory permissions are set correctly.
3. Verify that Python 3.12+ is installed and in the PATH.
4. Ensure that the mcp[cli] and requests packages are installed.

Development

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

1. Submit issues or pull requests.

📄 License

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

Acknowledgments

• MCP framework maintainers: Thanks for standardizing the interaction of AI tools.
• Model Context Protocol community: Thanks for the documentation and examples.