Unreal Engine

🚀 Unreal MCP 服务器测试脚本

本项目的测试脚本可用于对 Unreal MCP Server 的各项功能进行全面测试，能帮助开发者快速验证服务器功能的正确性和稳定性。

🚀 快速开始

运行测试

你既可以单独运行每个测试，也能按顺序运行所有测试。

单独运行测试

python 1_basic_connection.py
python 2_python_execution.py
python 3_string_test.py

按顺序运行所有测试

python run_all_tests.py

✨ 主要特性

这些脚本可对 MCP Server 的多种功能进行测试：

1. 基本连接测试 (1_basic_connection.py)：用于测试与 MCP Server 的基本连接是否正常。
2. Python 执行测试 (2_python_execution.py)：可测试通过 MCP Server 执行 Python 代码的功能。
3. 字符串处理测试 (3_string_test.py)：能测试各种字符串格式以及可能存在问题的区域。

📦 安装指南

测试要求

• MCP Server 必须在 Unreal Engine 中运行。
• 需要 Python 3.6 或更高版本。
• 需使用套接字和 JSON 模块（标准库包含）。

💻 使用示例

基本用法

MCP Server 期望收到以下格式的命令：

{
  "type": "command_name",
  "code": "python_code_here"  // 对于execute_python命令
}

命令应作为 JSON 字符串发送，后面跟一个换行符。

📚 详细文档

故障排除

如果你在测试过程中遇到问题，可按以下步骤排查：

1. 确保 MCP Server 在 Unreal Engine 中处于运行状态。
2. 检查是否连接到正确的主机和端口（默认：localhost:13377）。
3. 验证命令格式是否正确。
4. 查看 Unreal Engine 日志中的任何错误信息。

添加新测试

添加新测试时，请遵循现有测试的模式：

1. 连接到服务器。
2. 发送命令。
3. 接收并处理响应。
4. 返回成功或失败。

使用sys.exit()代码表示测试成功（0）或失败（非零）。