WolvenKit MCP-赛博朋克2077改装工具
允许Claude Code访问的MCP服务器 WolvenKit 的 赛博朋克2077改装版。提取档案，将游戏文件转换为JSON，检查网格和纹理，管理模组，构建模组项目——所有这些都可以从您的终端完成。
离线工作（无需运行游戏）。与配对 CET-MCP 完整的人工智能辅助建模管道。
运作原理
Claude Code → stdio/JSON-RPC → MCP Server → WolvenKit CLI (cp77tools) → filesystem
需求
dotnet tool install -g WolvenKit.CLI
设置
# 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 | /archive/pc/mod | Mod安装目录 |
WSL2注释
MCP服务器在WSL2上运行，但通过以下方式调用Windows WolvenKit CLI cmd.exe。WSL之间的路径会自动转换(/mnt/g/...)和Windows(G:\...)格式。
许可证
麻省理工学院
