fmodel-mcp

MCP server điều khiển FModel (trình duyệt asset Unreal Engine) qua Windows UI Automation — không cần chạm chuột vật lý.

Kiến trúc

opencode ── MCP (stdio) ──> src/index.ts ──> src/bridge.ts ──> bridge/uia.ps1 (-Server) ──> FModel (UI Automation)

• src/index.ts — MCP server, 19 tools.

• src/bridge.ts — wrapper daemon: giữ 1 tiến trình pwsh sống, tuần tự hoá request qua promise queue, tự respawn khi lỗi/timeout.

• bridge/uia.ps1 — PowerShell bridge: nhận 1 JSON/line từ stdin, trả 1 JSON/line ra stdout. Kích hoạt bằng UIA pattern (Invoke/Select/SetFocus + {ENTER}/Shift+F10), không dùng SetCursorPos/mouse_event.

Related MCP server: uiautomation-mcp

Cài đặt

npm install
npm run build

Yêu cầu: Windows + PowerShell 7 (pwsh), FModel đang chạy.

Đăng ký vào opencode

Thêm vào ~/.config/opencode/opencode.jsonc:

{
  "mcp": {
    "fmodel": {
      "type": "local",
      "command": ["node", "C:/Users/<bạn>/Desktop/temp/fmodel_mcp/dist/index.js"],
      "enabled": true
    }
  }
}

Tools chính

Quy trình tìm kiếm asset

1. send_keys ^f để mở cửa sổ Search For Packages.

2. set_value vào SearchTextBox với chuỗi cần tìm.

3. click_element vào chính SearchTextBox (fallback thành {ENTER} → kích hoạt RefreshFilter của cửa sổ Search).

4. list_files (với window: "Search For Packages") để đọc kết quả.

Lưu ý: tìm kiếm là substring-match trên FullPath, kết quả bị ảo hoá (~24 dòng hiển thị).

Dev

npm run dev   # chạy bằng tsx
npm run build # biên dịch TypeScript

Test nhanh bridge không qua MCP:

pwsh -NoProfile -File bridge/uia.ps1 -Action processes