fmodel-mcp
Allows controlling FModel, an Unreal Engine asset browser, via Windows UI Automation to browse, search, inspect, and export Unreal Engine assets without physical mouse input.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
FModel MCP v2
MCP server (stdio) đọc trực tiếp file .pak của Unreal Engine bằng CUE4Parse — không cần mở FModel GUI.
Khác với v1 (UI Automation), v2 mount pak và đọc asset bằng code, nên nhanh hơn nhiều và có thêm các tool phân tích cấu trúc (widget tree, object search, dependency, extract file thô).
Yêu cầu
Windows / Linux / macOS
.NET 8 SDK (nếu build từ source) hoặc .NET 8 Runtime (nếu chạy bản có sẵn)
File
.pakcủa game (không kèm theo repo)AES key của game nếu pak bị mã hoá
Related MCP server: uiautomation-mcp
Cài đặt
Cách 1 — Build từ source (khuyến nghị khi dev)
git clone https://github.com/5coinin1/fmodel_mcp.git
cd fmodel_mcp
dotnet build -c ReleaseFile chạy: bin/Release/net8.0/FModelMcp.dll
Cách 2 — Publish 1 file exe self-contained
./publish.ps1Kết quả: dist/FModelMcp.exe (~35 MB, không cần cài .NET trên máy đích).
Đăng ký MCP
opencode (~/.config/opencode/opencode.jsonc)
{
"mcp": {
"servers": {
"fmodel-v2": {
"type": "local",
"command": ["dotnet", "C:\\path\\to\\FModelMcp.dll"]
}
}
}
}Hoặc dùng bản exe:
"fmodel-v2": {
"type": "local",
"command": ["C:\\path\\to\\dist\\FModelMcp.exe"]
}Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"fmodel-v2": {
"command": "C:\\path\\to\\dist\\FModelMcp.exe"
}
}
}Cursor (.cursor/mcp.json)
{
"mcpServers": {
"fmodel-v2": {
"command": "C:\\path\\to\\dist\\FModelMcp.exe"
}
}
}Quy trình sử dụng
load_package— mount thư mục pak (gọi 1 lần mỗi session):{ "directory": "D:/Game/Content/Paks", "game_version": "UE4_25", "aes_key": "0x..." }search_assets/browse_assets— tìm asset theo tên hoặc duyệt theo path.load_asset/read_properties— xem export list và property.find_objects/get_class/get_dependencies— phân tích sâu bên trong asset.export_asset— dump toàn bộ object ra file text.extract_file/extract_files— lấy file thô (Lua, CSV, JSON, ...) ra khỏi pak.
Ví dụ
// 1. Mount
{"name":"load_package","arguments":{
"directory":"D:/CalabiYau/PM/Content/Paks",
"game_version":"UE4_25",
"aes_key":"0x7456667C...CDE40"
}}
// 2. Tìm widget chat
{"name":"search_assets","arguments":{"query":"WBP_Chat","limit":50}}
// 3. Đọc property của export đầu tiên
{"name":"read_properties","arguments":{
"asset_path":"PM/Content/PaperMan/UI/BP/PC/Frontend/Chat/WBP_ChatInput.uasset",
"export_index":0
}}
// 4. Tìm button bên trong widget
{"name":"find_objects","arguments":{
"asset_path":"PM/Content/PaperMan/UI/BP/PC/Frontend/Chat/WBP_ChatInput.uasset",
"name":"Btn_Send"
}}
// 5. Extract Lua
{"name":"extract_file","arguments":{
"file_path":"PM/Content/Script/Business/Chat/Init.lua",
"output_dir":"C:/exports/lua"
}}Danh sách tool (15)
Tool | Tham số | Chức năng |
|
| Liệt kê file |
|
| Mount pak, khởi tạo provider |
|
| Duyệt asset theo path (phân trang) |
|
| Tìm asset theo substring |
|
| Trả về danh sách export (tên, type, outer) |
|
| Đọc toàn bộ property của 1 export |
|
| Liệt kê cây thư mục |
| — | Thống kê provider (số file, extension) |
|
| Class name + chuỗi kế thừa |
|
| Tìm object bên trong asset |
|
| Asset mà asset này tham chiếu tới |
|
| Asset tham chiếu tới asset này (quét chậm) |
|
| Export toàn bộ object ra |
|
| Extract 1 file thô từ pak |
|
| Extract nhiều file thô |
Lưu ý & giới hạn
AES key: pak của nhiều game bị mã hoá. Key có thể lấy từ
FModel/AppSettings.json(mụcAesKeys.mainKey) hoặc cộng đồng. Truyền vàoload_package.Đường dẫn asset: CUE4Parse dùng path dạng
PM/Content/...(theo pak), không phải/Game/.... Dùngsearch_assetsđể xem path thật.Blueprint function bodies: CUE4Parse không decompile bytecode Blueprint, nên
export_assetchỉ có metadata/property, không có logic function.Lua:
extract_filelấy được bytes thô. Một số game mã hoá nội dung file (file-level encryption) — khi đó bytes vẫn là ciphertext, cần key riêng để giải mã. Nếu không mã hoá, file là Lua bytecode và có thể decompile bằngunluac(nếu dùng Slua/UnLua).UStringTable / UDataTable: có thể chỉ export được metadata (RowStruct) do CUE4Parse chưa deserialize đầy đủ; dùng
extract_filevới file CSV gốc nếu có trong pak.get_referencesquét toàn bộ pak (hàng trăm nghìn file) nên rất chậm — chỉ dùng khi thật cần.Output mặc định là thư mục
exports/tương đối theo working directory của client. Nên truyềnoutput_dirtuyệt đối.
Troubleshooting
Lỗi | Nguyên nhân / cách xử lý |
| Chưa gọi |
| Sai path — dùng |
| Thiếu/sai |
Build lỗi | MCP server đang chạy giữ DLL — tắt client hoặc |
Không thấy tool trong client | Kiểm tra |
Cấu trúc project
fmodel_mcp/
├── Program.cs # MCP server (JSON-RPC stdio + 15 tools)
├── FModelMcp.csproj # net8.0 + CUE4Parse 1.0.5
├── publish.ps1 # publish self-contained single-file
└── README.mdLicense
Chỉ dùng cho mục đích học tập/nghiên cứu trên asset bạn sở hữu hợp pháp.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Securely control computers you explicitly pair through files, terminals, processes, screenshots, desktop UI/input, clipboard, browser automation, diagnostics, and document tools.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to control Windows systems using AutoHotkey v2 and the UI Automation accessibility tree for efficient, text-based computer interaction. It provides tools for window management, keystrokes, and UI inspection while significantly reducing token costs compared to screenshot-based approaches.9MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to inspect and automate Windows desktop UI elements by exploring UI trees, checking properties, performing actions like clicking and typing, and generating Python automation scripts.MIT
- AlicenseNot gradedqualityCmaintenanceEnables Windows UI Automation through MCP, allowing agents to inspect, search, navigate, and interact with desktop UI elements via the UIAutomation framework. Supports actions such as focus, invoke, set-value, toggle, and event waiting, with CLI and VS Code extension variants.4MIT
- AlicenseNot gradedqualityBmaintenanceEnables reading and interacting with native Windows application UI through the UI Automation API, allowing listing windows, extracting structured content, and performing clicks/typing without screenshot-based vision.2MIT