Internet Speed Test

🚀 MCP 網絡速度測試服務器

MCP 網絡速度測試服務器是一個用於互聯網速度測試的工具，它基於 Model Context Protocol (MCP) 實現。藉助該服務器，AI 模型和代理能夠通過標準化接口測量、分析並報告網絡性能指標。

🚀 快速開始

本服務器是一個實驗性的 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 社區：感謝文檔和示例