AI导哈

赛博朋克2077模组工具

WolvenKit MCP是一个为赛博朋克2077提供模组开发支持的工具集，支持存档提取、游戏文件转换、资源检查、模组管理及构建等功能。

  • by Y4rd13
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 Y4rd13/wolvenkit-mcp

使用说明

WolvenKit MCP-赛博朋克2077改装工具

允许Claude Code访问的MCP服务器 WolvenKit 的 赛博朋克2077改装版。提取档案，将游戏文件转换为JSON，检查网格和纹理，管理模组，构建模组项目——所有这些都可以从您的终端完成。

离线工作（无需运行游戏）。与配对 CET-MCP 完整的人工智能辅助建模管道。

运作原理

Claude Code → stdio/JSON-RPC → MCP Server → WolvenKit CLI (cp77tools) → filesystem

需求

  • Node.js >= 18
  • WolvenKit命令行界面 （通过.NET安装）：
    dotnet tool install -g WolvenKit.CLI
  • 赛博朋克2077 （游戏档案）

设置

# 1. Clone and build
git clone https://github.com/Y4rd13/wolvenkit-mcp.git
cd wolvenkit-mcp
npm install
npm run build

# 2. Add to Claude Code globally
claude mcp add wolvenkit -s user \
  -e "WOLVENKIT_CLI=cp77tools" \
  -e "CP77_GAME_DIR=/path/to/Cyberpunk 2077" \
  -e "CP77_MOD_DIR=/path/to/Cyberpunk 2077/archive/pc/mod" \
  -- node /path/to/wolvenkit-mcp/build/index.js

工具（45）

归档操作

工具 说明
unbundle_archive 使用通配符过滤器从.archive中提取文件
pack_archive 将文件夹打包到.archive中
archive_info 列出存档中的所有文件
list_archives 列出所有游戏档案
search_archives 按模式在所有游戏档案中搜索文件
list_installed_mods 列出已安装的mod存档及其大小
mod_conflicts 检测已安装mods之间的文件冲突

文件转换

工具 说明
convert_to_json RED引擎文件→ 可编辑JSON
convert_from_json JSON→重新定义文件
inspect_file 游戏文件的快速结构摘要
get_game_file 一步：在档案中查找→ 提取→ 转换为JSON
batch_convert 一次将多个文件转换为JSON
patch_json 修改游戏文件JSON中的特定字段

资产检查

工具 说明
get_file_dependencies 列出游戏文件引用的所有文件
extract_mesh_info 网格细节：子网格、材质、骨骼
get_texture_info 纹理细节：分辨率、格式、mipmaps
list_entity_components 列出实体组件和外观
find_appearances 按模式搜索.app文件
find_materials 列出网格使用的所有材料
list_inkatlas_slots 列出UI纹理图集插槽
get_animation_list 列出.anims/.rig文件中的动画
search_game_files 在存档中按扩展名+模式搜索

资产导出/导入

工具 说明
export_file 导出为原始格式（网格→GLB，纹理→PNG）
import_file 将原始文件导入回REDengine格式
uncook_archive 一步提取+导出

Mod项目

工具 说明
create_mod_project 搭建一个现代化的项目结构
build_mod 打包并可选择安装mod到游戏中
list_project_files 列出mod项目中的文件
copy_to_project 将游戏文件直接提取到mod项目中
validate_mod 检查项目结构并报告问题
strip_unused 在项目中查找未引用/孤立的文件
get_cooked_size 按文件类型估算最终模块大小
generate_tweakxml 生成TweakXL YAML模板

Mod管理

工具 说明
backup_archive 创建存档的.bak备份
restore_archive 从.bak备份还原存档
compare_archives 比较mod存档与原始（添加/删除的文件）
merge_archives 将多个存档源合并为一个
install_mod_from_url 从直接URL下载并安装mod

信息与分析

工具 说明
wolvenkit_status CLI版本、路径、可用性检查
hash_value 计算游戏路径的FNV1a64哈希值
find_by_hash 按哈希值搜索文件
diff_files 比较两个显示更改的REDengine文件
analyze_performance 估计mod性能影响（网格/纹理大小）
decompile_script 在存档中搜索脚本文件（.reds、.ws）
generate_xlmap 生成ArchiveXL资源映射模板

配置

变量 默认值 描述
WOLVENKIT_CLI cp77tools WolvenKit命令行界面
CP77_GAME_DIR （参见.mcp.json） 游戏安装路径
CP77_MOD_DIR <game>/archive/pc/mod Mod安装目录

WSL2注释

MCP服务器在WSL2上运行，但通过以下方式调用Windows WolvenKit CLI cmd.exe。WSL之间的路径会自动转换(/mnt/g/...)和Windows(G:\...)格式。

许可证

麻省理工学院

相关 MCP