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）或失敗（非零）。