Skip to main content
Glama

Umodel-MCP

License: MIT GitHub

面向 umodel 的 MCP 服务器, 让任意 MCP 客户端通过自然语言完成 Unreal Engine 游戏资源的列表、解包、导出操作

特性

  • 纯解包零依赖pak_list / pak_extract 为纯 TypeScript 实现,直接解析 .pak 索引并提取原始 .uasset/.uexp 文件,无需下载 umodel

  • 支持加密 pak:AES-256 索引/条目加密,含标准模式与 bitflip 变体; 密钥仅存会话内存

  • 完整导出链路:网格、贴图、动画、声音导出为 gltf、psk、png、dds 等格式 (依赖 umodel 可执行文件)

Related MCP server: Adastrea-MCP

环境要求

  • Node.js 18 或更高版本

  • 任意支持 MCP 的客户端(Hermes 、Claude Code、Cursor、PI、Codex 等)

  • 仅导出转换功能需要:umodel

安装

标准配置

{
  "mcpServers": {
    "umodel": {
      "command": "npx",
      "args": ["-y", "umodel-mcp"]
    }
  }
}

也可以直接把这句话发给你的 agent:"帮我安装并注册 umodel-mcp,重载 MCP 连接后验证可用"

各客户端注册方式

客户端

注册方式

Claude Code

claude mcp add umodel npx -- -y umodel-mcp

Codex

codex mcp add umodel npx "-y" "umodel-mcp"

Pi

标准配置写入 ~/.pi/agent/mcp.json,然后 /reload

git clone git@github.com:CHA1007/Umodel-MCP.git
cd Umodel-MCP
npm install
npm run build

然后在 MCP 客户端配置中注册:

{
  "mcpServers": {
    "umodel": {
      "command": "node",
      "args": ["<本仓库绝对路径>/dist/index.js"]
    }
  }
}

工具

工具

对应 umodel 命令

说明

umodel_session_get

查看当前内存会话设置

umodel_session_set

记住会话设置(仅内存,不落盘)

umodel_find_exe

自动搜索 umodel 可执行文件(仅当用户不知道路径时兜底)

umodel_version

-version

验证可执行文件(可传 exe 测试并记住新路径)

umodel_game_list

-gamelist / -taglist

查看支持的游戏及 -game= 标签

umodel_list_packages

递归扫描目录中的 .pak/.upk/.uasset/.ut2 等包文件

umodel_list_objects

-list

列出包内对象(支持过滤与分页)

umodel_package_info

-pkginfo

查看包信息(name/export 表)

umodel_export

-export

导出网格/贴图/动画/声音(psk、gltf、png、dds…)

umodel_save

-save

原样拷出原始包文件(.upk + .uexp/.ubulk)

umodel_list_output

查看导出结果目录树(含文件大小)

pak_list

直接解析 .pak 索引(不经 umodel),支持 AES 加密索引,搜索资产路径

pak_extract

从 .pak 中提取原始 .uasset/.uexp 文件(含加密 pak)

命令行参数以 UEViewer 官方源码(UmodelTool/Main.cpp)为准; 每个工具的具体参数可在 MCP 客户端中查看其 schema

免责声明

  • 本项目仅用于解包、查看与导出用户自己合法持有的游戏资源, 用于学习、研究、备份等合法用途

  • 请遵守相关游戏的用户协议与所在地区的法律法规; 因使用本项目产生的任何版权、协议纠纷或损失,作者概不负责

许可证

MIT © CHA1007

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…

  • MCP server for AI dialogue using various LLM models via AceDataCloud

  • An MCP server for deep research or task groups

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/CHA1007/Umodel-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server