项目简介

这是一个基于 Model Context Protocol (MCP) 实现的网络速度测试服务器。它允许大型语言模型 (LLM) 或其他 AI 客户端通过标准化的接口来测量、分析和报告网络性能指标。

主要功能点

测量下载速度: 测试当前网络的下载带宽。
测量上传速度: 测试当前网络的上传带宽。
测量网络延迟: 测试到指定服务器的网络响应时间。
分析网络抖动: 通过多次延迟测量，计算网络延迟的波动程度。
运行完整测试: 一次性执行所有主要测试，并提供综合报告。

安装步骤

服务器需要 Python 3.12 或更高版本。推荐使用 'uv' 包管理器进行安装和运行。

使用 uvx (推荐): 'uvx' 命令可以直接运行 Python 包而无需显式安装。只需使用命令 'uvx /你的/mcp-internet-speed-test/项目/路径' 即可启动服务器。
使用 Docker: 如果你的环境支持 Docker，可以构建并运行 Docker 镜像：首先，在项目根目录下执行 'docker build -t mcp-internet-speed-test .' 构建镜像。然后，使用 'docker run -it --rm -v $(pwd):/app -w /app mcp-internet-speed-test' 命令运行容器。

服务器配置 (供MCP客户端使用)

要让你的 MCP 客户端 (如 Claude Desktop) 使用此服务器，你需要在客户端的 MCP 配置文件中添加服务器信息。配置通常是一个 JSON 结构，你需要指定服务器的名称以及启动它的命令和参数。

例如，在客户端的 MCP 配置中，你可以添加类似以下结构的条目：

{
    "mcpServers": {
        "给服务器起一个名称": {
            "command": "启动服务器的命令",
            "args": [
                "命令所需的参数",
                "例如：服务器项目的绝对路径"
            ]
        }
        // ... 其他 MCP 服务器配置
    }
}

对于此网络速度测试服务器，如果使用 'uvx' 方式启动，并且你的客户端支持直接调用 'uvx'，配置可能如下：

服务器名称: 可以是任意你喜欢的名称，比如 'internet-speed-test'。
command: 填写 'uvx'。
args: 填写包含服务器项目绝对路径的列表，例如 '["/usr/local/bin/mcp-internet-speed-test"]' 或 '["/home/user/projects/mcp-internet-speed-test"]'。请确保这里的路径是服务器代码在你系统上的绝对路径。

完成配置后，重启 MCP 客户端，它应该能发现并连接到此服务器提供的工具。

基本使用方法

一旦 MCP 客户端成功连接到此服务器并加载了其提供的工具（即上述“主要功能点”中列出的各项测试），LLM 或 AI Agent 就可以通过 MCP 协议调用这些工具来执行网络速度测试。例如，AI 可以调用 'run_complete_test' 工具来获取全面的网络性能报告。AI 如何具体调用这些工具取决于 MCP 客户端和 AI 模型本身的集成方式。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (供MCP客户端使用)

基本使用方法

信息