Funplay Unreal MCP
ภาพรวม
คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)
stdio bridge for the local Unreal Editor MCP server from FunplayAI/funplay-unreal-mcp.
สามเสาของ PopNx MCP
สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน
- เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
- ผลตรวจเบื้องต้นของเราiผ่าน 2 จาก 2 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
- การใช้งานiยังใหม่มาก↓ 75/สัปดาห์ · ★ 8
ใช้ทำอะไรได้
ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry
- การเชื่อมต่อ: รันบนเครื่อง
- ช่องทาง (transport): stdio
- หมวด: เครื่องมือนักพัฒนา
- ต้องใส่ค่าเหล่านี้: FUNPLAY_UNREAL_MCP_TOKEN, UNREAL_MCP_TOKEN
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ก่อนติดตั้ง
- ผลตรวจเบื้องต้น: ผ่าน 2 จาก 2 ข้อ
- รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
- ค่าที่คุณต้องใส่เอง:
FUNPLAY_UNREAL_MCP_URL,UNREAL_MCP_URL,FUNPLAY_UNREAL_MCP_TOKEN,UNREAL_MCP_TOKEN
ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต
ต้องเตรียมก่อน
คุณใช้แอปไหน
เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”
เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json
{
"mcpServers": {
"funplay-unreal": {
"command": "npx",
"args": [
"-y",
"funplay-unreal-mcp"
],
"env": {
"FUNPLAY_UNREAL_MCP_URL": "ใส่ค่าของคุณ",
"UNREAL_MCP_URL": "ใส่ค่าของคุณ",
"FUNPLAY_UNREAL_MCP_TOKEN": "ใส่ค่าของคุณ",
"UNREAL_MCP_TOKEN": "ใส่ค่าของคุณ"
}
}
}
}พิมพ์คำสั่งนี้ใน Terminal
claude mcp add funplay-unreal --env FUNPLAY_UNREAL_MCP_URL='ใส่ค่าของคุณ' --env UNREAL_MCP_URL='ใส่ค่าของคุณ' --env FUNPLAY_UNREAL_MCP_TOKEN='ใส่ค่าของคุณ' --env UNREAL_MCP_TOKEN='ใส่ค่าของคุณ' -- npx -y funplay-unreal-mcpเติมค่าที่เว้นว่างไว้ก่อนรัน
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"funplay-unreal": {
"command": "npx",
"args": [
"-y",
"funplay-unreal-mcp"
],
"env": {
"FUNPLAY_UNREAL_MCP_URL": "ใส่ค่าของคุณ",
"UNREAL_MCP_URL": "ใส่ค่าของคุณ",
"FUNPLAY_UNREAL_MCP_TOKEN": "ใส่ค่าของคุณ",
"UNREAL_MCP_TOKEN": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"funplay-unreal": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"funplay-unreal-mcp"
],
"env": {
"FUNPLAY_UNREAL_MCP_URL": "ใส่ค่าของคุณ",
"UNREAL_MCP_URL": "ใส่ค่าของคุณ",
"FUNPLAY_UNREAL_MCP_TOKEN": "ใส่ค่าของคุณ",
"UNREAL_MCP_TOKEN": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น
ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี
ค่าที่ต้องใส่เอง
FUNPLAY_UNREAL_MCP_URLenvOptional Unreal MCP HTTP endpoint. Defaults to http://127.0.0.1:8765/.UNREAL_MCP_URLenvCompatibility endpoint variable used when FUNPLAY_UNREAL_MCP_URL is not set.- Unreal MCP local auth token from the Funplay MCP editor menu or Saved/FunplayMCP/funplay_mcp_settings.json.
- Compatibility token variable used when FUNPLAY_UNREAL_MCP_TOKEN is not set.
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
ใช้กับโปรแกรมไหนได้
ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ติดตั้งบนเครื่องได้ใน
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
ทำอะไรได้บ้าง
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 10 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub FunplayAI ซึ่งเป็นเจ้าของ repo
- ✓ ผ่าน
ยังมีคนดูแล
มีการแก้โค้ดล่าสุด 5 เดือนที่ผ่านมา
- … ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- – ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
- – ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
เทียบกับตัวอื่นในหมวด เครื่องมือนักพัฒนาi
- ดาวมากกว่า 87% ของอีก 5725 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 19% ของอีก 5725 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 5725 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
Funplay Unreal MCP ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 2 จาก 2 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
ต้องใส่ค่าเหล่านี้: FUNPLAY_UNREAL_MCP_TOKEN, UNREAL_MCP_TOKEN
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด 5 เดือนที่ผ่านมา และส่งรุ่นล่าสุด (0.2.0) เข้า registry 5 เดือนที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี REA, Netdata, Front-End Checklist
ตัวที่ใช้แทนได้
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Netdata
Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Front-End Checklist
Review frontend code and live pages against 386 quality-gated web development rules.
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
Funplay MCP for Unreal The most advanced MCP server for the Unreal Editor.
中文 | English
💖 If this saves you time, please star the repo — it helps a lot.
Funplay MCP for Unreal lets AI assistants — Claude Code, Cursor, Windsurf, Codex, VS Code Copilot and any other MCP client — operate directly inside a running Unreal Editor. It is a pure-Python editor plugin (no C++ build, works across Unreal Engine 5.3–5.8) that exposes the editor over a local MCP server, plus a tiny Node.js stdio bridge that connects your AI client to it. MIT-licensed and free for commercial use.
Describe what you want in natural language — *spawn and arrange actors, build levels and Blueprints, create materials, import assets, drive Play-In-Editor, capture screenshots, or run arbitrary execute_python* — and let the assistant do it.
"Build a small arena: a floor, four walls, some point lights, and a player
start in the middle. Then play it and send me a screenshot."
The assistant inspects the level, spawns and positions the actors, sets up
lighting, enters Play-In-Editor, and returns a screenshot — all through this
MCP server.
Demo
Codex asks for a castle, Funplay MCP drives the Unreal Editor through MCP, and the finished scene appears directly in the editor.
Quick Start
Three things: (1) drop the plugin into your project, (2) enable it and start the server, (3) point your AI client at it.
1. Install the plugin
💡 The plugin is pure Python — there is nothing to compile.
- Copy the
FunplayMCP/folder into your project'sPlugins/directory (/Plugins/FunplayMCP/), or downloadFunplay.UnrealMcp.vX.Y.Z.zipfrom the latest Release and extract it there. - It depends on the engine's Python Editor Script Plugin, which the
.upluginenables automatically.
2. Enable and start the MCP Server
- Open your project. In Edit → Plugins, confirm Funplay MCP for Unreal is enabled, then restart the editor if prompted.
- On startup the server listens at
http://127.0.0.1:8765/by default. If the port is busy it automatically picks a free local port (and a second editor of the *same* project attaches to the existing server). - A per-project auth token is generated and stored in
/Saved/FunplayMCP/funplay_mcp_settings.json. - Get the endpoint and token any time from **Tools → Funplay MCP → Log Endpoint
- Token** (printed to the Output Log).
3. Configure your AI client
The fastest path is the editor menu: Tools → Funplay MCP → Configure Claude Code (or Cursor / VS Code / Codex). It writes the right config with the endpoint and token filled in.
Manual configuration
Claude Code (~/.claude.json), Cursor (~/.cursor/mcp.json):
{
"mcpServers": { "funplay-unreal": { "command": "npx", "args": ["-y", "funplay-unreal-mcp"], "env": { "FUNPLAY_UNREAL_MCP_URL": "http://127.0.0.1:8765/", "FUNPLAY_UNREAL_MCP_TOKEN": " " } } } }
VS Code (mcp.json) uses the servers key; Codex (~/.codex/config.toml) uses a [mcp_servers."funplay-unreal"] table. Both are written for you by the one-click menu.
4. Verify the connection
Ask your assistant to:
- call
get_project_info, - read the resource
unreal://project/context, - run
execute_pythonwithresult = unreal.SystemLibrary.get_engine_version().
Before You Start
- Editor only. The server runs inside the Unreal Editor; it does not ship in packaged games.
- Loopback only. It binds
127.0.0.1and rejects non-loopback Origins; POST requests require the per-project auth token. - Default `core` profile. A focused 32-tool set is exposed by default; switch to
full(97 tools) in the settings file when you want everything. - `execute_python` safety checks are on by default (a filesystem/process denylist); pass
safety_checks=falseto override per call. - All
unrealAPI work is marshalled onto the game thread, so the editor never crashes from off-thread access.
Why This Project
- `execute_python` first. A first-class tool that runs arbitrary Python in the editor — anything the 96 dedicated tools don't cover, you can still do.
- API discovery built in.
search_api/describe_class/inspect_objectread the embeddedunrealmodule's own docs, so the assistant uses the real API instead of hallucinating it. - Pure Python, no build. No C++ module, no compile step, portable across UE 5.3–5.8.
- Safe by construction. Game-thread marshalling, loopback binding, auth token, and DNS-rebinding protection out of the box.
- One-click client config + project skills. Configure Claude Code / Cursor / VS Code / Codex and generate an
AGENTS.mdbridge from the editor menu. - Same family, same conventions as Funplay MCP for Unity / Godot / Cocos.
Highlights
- 97 built-in tools (32 in the default
coreprofile) across 20 categories. - MCP resources (
unreal://...) for project, level, selection, logs, and the tool catalog, plus prompt templates for common workflows. - Structured results — every tool returns JSON the assistant can reason over; screenshots come back as inline images.
- Auto port-fallback and same-project instance attach.
- Zero-dependency Node bridge published to npm as
funplay-unreal-mcp.
MCP Capabilities
- Tools: 97 (32 core / 97 full).
- Primary execution:
execute_python— run any Python snippet in the editor. - Prompts:
level_review,feature_plan,debug_runtime,blueprint_actor. - Resources:
unreal://project/context,unreal://project/info,unreal://level/current,unreal://actors/list,unreal://selection/current,unreal://tools/catalog,unreal://logs/recent,unreal://interaction/history, plus templatesunreal://actor/{ref}andunreal://asset/{path}.
Comparison with Funplay MCP for Unity
| Funplay MCP for Unreal | Funplay MCP for Unity | |
|---|---|---|
| Editor side | Pure-Python plugin (no build) | C# package |
| Primary execution | execute_python (embedded unreal) | execute_code (in-memory C#) |
| Transport | Local HTTP + stdio bridge | Local HTTP + stdio bridge |
| Default exposure | core profile (32 of 97) | core profile |
| Engine versions | UE 5.3–5.8 | Unity 2022.3+ |
| Client config | One-click (Claude/Cursor/VS Code/Codex) | One-click |
Built-in Tools
97 built-in tools (32 core). Call get_tool_catalog for the live list.
| Category | Tools |
|---|---|
| Execution | execute_python, run_console_command |
| Reflection | search_api, describe_class, list_enum_values, inspect_object |
| Actors | spawn_actor, spawn_actor_from_asset, destroy_actor, duplicate_actor, set_actor_transform, set_actor_label, set_actor_property, attach_actor, get_actor_info, list_actors, find_actors, batch_spawn_actors |
| Components | add_component, list_components, get_component_properties, set_component_property, set_static_mesh, set_material, set_physics_properties, add_ism_instances |
| Assets | list_assets, find_assets, get_asset_info, duplicate_asset, rename_asset, delete_asset, save_asset, import_asset, create_folder, asset_exists, get_asset_references |
| Blueprints | create_blueprint, add_blueprint_component, compile_blueprint, get_blueprint_info, spawn_blueprint |
| Materials | create_material, create_material_instance, set_material_instance_parameter, get_material_info, add_material_expression, connect_material_expressions, connect_material_property, recompile_material |
| Levels | new_level, load_level, save_current_level, save_all_dirty, get_level_info, list_levels |
| Play-In-Editor | play_in_editor, stop_play_in_editor, simulate_in_editor, get_play_state |
| Viewport | set_viewport_camera, get_viewport_camera, focus_viewport |
| Screenshots | take_screenshot |
| Selection | get_selection, set_selection, select_none, get_selected_assets |
| Editor State | get_editor_state, get_project_info, get_output_log, sync_content_browser, health_status, undo, redo |
| Files | read_file, write_file, list_directory, file_exists |
| Procedural | build_wall, build_floor, build_stairs, scatter_actors |
| Organization | set_actor_folder, create_layer, add_actors_to_layer, list_layers |
| Data | create_data_table, get_data_table, set_data_table_rows, export_data_table_csv |
| UMG | create_widget_blueprint, add_widget, set_widget_property |
| Effects | spawn_niagara_system, set_niagara_parameter |
| Discovery | get_tool_catalog |
Repository Layout
FunplayMCP/ # the Unreal editor plugin (pure Python)
FunplayMCP.uplugin Content/Python/ init_unreal.py # auto-run entry point funplay_mcp/ # server, transport, registry, providers tools/ # one module per tool category stdio-wrapper/ # zero-dependency Node.js stdio<->HTTP bridge scripts/ # validate_repo.py, package_release.py tests/ # Node + Python tests (run without the editor) server.json # MCP registry manifest
Architecture
AI client (Claude Code / Cursor / ...)
│ stdio (MCP JSON-RPC) ▼ funplay-unreal-mcp (Node bridge, npx) │ HTTP + token → 127.0.0.1:8765 ▼ Unreal Editor plugin (Python) │ game-thread pump (register_slate_post_tick_callback) ▼ unreal API → Actors / Assets / Blueprints / Levels / PIE
Contributing
See CONTRIBUTING.md. Run python3 scripts/validate_repo.py before opening a PR.
License
MIT — see LICENSE.