M
Mcpingtester
by @WZLNa
Minecraft 服务器测试工具 这是一个用于可以并发同时测试多个 Minecraft 服务器延迟和可用性的小工具,并能将结果排序后保存到文本文件中。
Created 8/30/2025
Updated 8 days ago
README
Repository documentation and setup instructions
Minecraft 服务器测试工具
这是一个用于测试 Minecraft 服务器延迟和可用性的 Python 工具。它支持多线程并发测试,并能将结果排序后保存到文本文件中。
项目包含两个版本
- 基础版 (
mc_server_tester_onlyping/
): 提供服务器延迟和连通性测试。 - 增强版 (
mc_server_tester/
): 在基础版功能上,增加了丢包率测试、更详细的日志记录和更强大的错误处理。
功能特点
- 多线程测试: 同时测试多个服务器,极大缩短测试时间。
- 智能目标获取: 优先读取同目录下的
targets.txt
文件,没有则使用内置的服务器列表。 - 结果排序: 将可用的服务器按延迟(基础版)或丢包率和延迟(增强版)排序,优先推荐优质服务器。
- 结果导出: 自动将测试结果保存到带有时间戳的文本文件中。
- 即开即用: 每个版本都提供了打包好的 Windows 可执行文件 (.exe),无需安装 Python 环境即可运行。
增强版额外功能
- 丢包率测试: 对每个服务器进行多次连接尝试,计算丢包率,网络质量评估更准确。
- 详细日志: 程序运行状态和错误信息会实时记录到
server_test_log.txt
文件中,方便排查问题。 - 更健壮的错误处理: 增强了代码的稳定性,避免意外崩溃。
使用方法
- 下载: 从 Release 页面或代码库下载整个项目或所需的版本文件夹。
- 运行:
- 直接双击运行文件夹内的
MinecraftServerTester.exe
。 - 或者,如果您有 Python 环境,可以运行
MinecraftServerTester.py
(需要安装concurrent.futures
等标准库,通常无需额外安装)。
- 直接双击运行文件夹内的
- 自定义服务器列表(可选):
- 在同目录下创建一个名为
targets.txt
的文本文件。 - 每行输入一个服务器地址(例如
mc.hypixel.net
或play.example.com:25566
)。 - 程序会优先使用此文件中的列表,否则将使用内置列表。
- 在同目录下创建一个名为
文件说明
通用文件 (两个版本文件夹内都有)
MinecraftServerTester.exe
: 打包好的 Windows 可执行程序。MinecraftServerTester.py
: 工具的 Python 源代码。targets.txt
: (需自建)用于自定义要测试的服务器列表。
增强版特有文件
build.spec
: PyInstaller 打包配置文件,用于从源代码生成exe
文件。
Quick Setup
Installation guide for this server
Install Package (if required)
uvx mcpingtester
Cursor configuration (mcp.json)
{
"mcpServers": {
"wzlna-mcpingtester": {
"command": "uvx",
"args": [
"mcpingtester"
]
}
}
}