MCP 网络速度测试服务器

⚠️ 实验版本

这是一个实验性的 Model Context Protocol (MCP) 服务器实现，用于互联网速度测试。它允许 AI 模型和代理通过标准化接口测量、分析并报告网络性能指标。

什么是 MCP？

模型上下文协议（MCP）为大型语言模型（LLMs）提供了与外部工具和数据源交互的标准方式。可以将其视为“AI 应用的 USB-C”——一个通用接口，使 AI 系统能够访问现实世界的功能和信息。

功能

• 下载速度测试：测量下载带宽
• 上传速度测试：通过配置文件大小进行上传带宽测试
• 延迟测试：测量到不同服务器的网络延迟
• 抖动分析：通过分析延迟波动计算网络抖动
• 全面报告：提供详细的 JSON 格式报告

安装指南

先决条件

• Python 3.12 或更高版本
• uv 包管理器（推荐）

方案 1：使用 uvx（推荐）

uvx 命令是一种直接运行 Python 包而无需显式安装的便捷方式：

# 直接运行 MCP 服务器
uvx /path/to/mcp-internet-speed-test

方案 2：使用 Docker

# 构建 Docker 镜像
docker build -t mcp-internet-speed-test .

# 使用 Docker 容器运行 MCP 服务器
docker run -it --rm -v $(pwd):/app -w /app mcp-internet-speed-test

配置

要将此 MCP 服务器与 Claude Desktop 或其他 MCP 客户端一起使用，请将其添加到您的 MCP 配置文件中。

Claude Desktop 配置

编辑您的 Claude Desktop MCP 配置文件：

{
    "mcpServers": {
        "mcp-internet-speed-test": {
            "command": "uvx",
            "args": [
                "/ABSOLUTE/PATH/TO/mcp-internet-speed-test"
            ]
        }
    }
}

API 工具

MCP 网络速度测试服务器提供了以下工具：

1. measure_download_speed：测量下载带宽（单位：Mbps）
2. measure_upload_speed：通过配置文件大小进行上传带宽测试
3. measure_latency：测量网络延迟（单位：ms）
4. measure_jitter：分析延迟波动以计算网络抖动
5. run_complete_test：运行所有测试并生成全面报告

故障排除

如果遇到连接 MCP 服务器的问题：

1. 确保配置文件中的路径正确
2. 检查目录权限是否正确
3. 验证 Python 3.12+ 是否已安装且在 PATH 中
4. 确保 mcp[cli] 和 requests 包已安装

开发

这是一个实验性项目，欢迎贡献。要参与贡献：

1. 提交问题或拉取请求

许可证

本项目 licensed under the MIT License - 请查看 LICENSE 文件获取详细信息。

致谢

• MCP 框架维护者：感谢统一 AI 工具交互标准
• Model Context Protocol 社区：感谢文档和示例