MCP 互联网速度测试

⚠️ 实验版本

这是一个用于互联网速度测试的模型上下文协议（MCP）服务器的实验性实现。它允许AI模型和代理通过标准化接口测量、分析和报告网络性能指标。

什么是MCP？

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

功能

• 下载速度测试：测量下载带宽
• 上传速度测试：使用可配置文件大小测量上传带宽
• 延迟测试：测量到不同服务器的网络延迟
• 抖动分析：通过分析延迟变化来计算网络抖动
• 综合报告：提供详细的JSON格式报告

安装

前提条件

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

选项1：使用 uvx（推荐）

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

bash

直接运行MCP服务器

uvx /path/to/mcp-internet-speed-test

选项2：使用 Docker

bash

构建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配置文件：

json
{
"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：测量网络延迟（单位：ms）
4. measure_jitter：通过分析延迟变化来测量网络抖动
5. run_complete_test：运行所有测试并提供综合报告

故障排除

如果您在连接MCP服务器时遇到问题：

1. 确保MCP配置中的路径正确
2. 检查您是否有该目录所需的权限
3. 确认已安装Python 3.12+ 并且其路径已添加到环境变量中
4. 确保已安装 mcp[cli] 和 httpx 包

开发

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

1. 提交问题或提交拉取请求

许可证

该项目根据MIT许可证发布 - 详情请参阅 LICENSE 文件。

致谢

• MCP框架维护者对AI工具交互进行标准化
• 模型上下文协议社区提供的文档和示例