Internet Speed Test

🚀 MCP 网络速度测试服务器

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

🚀 快速开始

MCP 网络速度测试服务器是一个实验性的 Model Context Protocol (MCP) 服务器实现，用于互联网速度测试。它允许 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？

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

配置

要将此 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. 提交问题或拉取请求。

📄 许可证

本项目遵循 MIT 许可证，请查看 LICENSE 文件获取详细信息。

致谢

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