WkMCP — 面向Wolvenkit的MCP服务器

WkMCP — 面向Wolvenkit的MCP服务器

基于Wolvenkit构建的MCP服务器，主要旨在简化使用Claude等模型时创建、维护和调试模组的过程。

WkMCP — 面向Wolvenkit的MCP服务器预览查看大图

WkMCP

AI 辅助《赛博朋克 2077》模组制作——通过模型上下文协议（MCP）将 WolvenKit 工具包开放给 AI 代理（Claude）。

⚠ 请先阅读——这不是游戏内模组

这是一个 Claude Desktop（或同类软件）的扩展（一个 MCP 服务器），不是放进游戏文件夹的模组。它不会进入 archive/pc/mod，也不能用 Vortex 或 Mod Organizer 安装。它为 Claude AI 助手提供了超过 120 个工具，帮助你读取、编辑、构建和诊断《赛博朋克 2077》模组。

⚠ 关于本 Nexus 下载

Nexus 不托管可执行文件，因此这里的文件是无二进制文件的配套包：包含本说明文档及可选的 CETBridge 游戏内模组。服务器本体（wkmcp.mcpb）需从 GitHub 下载——参见下文安装部分。

功能特性

  • 128 个工具、8 个提示词、4 个资源
  • 读写 .archive，CR2W ↔ JSON 转换，结构化 TweakDB 编辑
  • .archive 和 REDmod 打包，.cpmodproj 生成
  • 网格/纹理/动画/变形目标/mlmask 导出，opus 音频提取
  • REDscript 和 TweakXL 代码检查（专用解析器）
  • 模组诊断：mod_doctor、diagnose_logs、analyze_conflicts、validate_item_mod
  • 备份/恢复，游戏内迭代循环（启动 + 日志跟踪）
  • 可选的实时游戏内桥接（36 个 live_* 工具）：玩家状态、物品栏、传送、实时 TweakDB、任务事实——通过 CETBridge 模组实现

系统要求

  • Windows（使用原生 cp77tools 二进制文件）
  • .NET 8 运行时，且 dotnet 已加入 PATH 环境变量
  • Claude Desktop（或任何兼容 MCP 的客户端）
  • 仅 live_* 工具需要：游戏内安装 Cyber Engine Tweaks 以及随附的 CETBridge 模组

安装

Nexus 无法托管可执行文件，因此服务器捆绑包位于 GitHub 上，而本 Nexus 下载仅包含说明文档及以下内容：

  1. 从发布页面下载 wkmcp.mcpb。
  2. 用 Claude Desktop 打开它（设置 → 扩展 → 从文件安装），或按照 GitHub README 操作。
  3. 可选，仅用于 live_* 工具： 将 CETBridge 文件夹复制到 <Cyberpunk 2077>\bin\x64\plugins\cyber_engine_tweaks\mods\CETBridge。
  4. 之后工具便会出现在 Claude / 你的 MCP 客户端中。

源代码与许可证

完整源代码、文档和问题追踪：github.com/Guikingone/WkMCP

本捆绑包基于 GPL-3.0 许可（其中包含守护进程，该进程链接了 GPL-3.0 许可的 WolvenKit 库）；MCP 服务器源代码本身采用 MIT 许可，作为独立进程运行，仅通过 IPC 与守护进程通信。在 GPL 许可下可允许使用/再分发/修改本捆绑包（该许可证即所需许可），但须保留上述声明及对应源代码的链接。随附的 LICENSE/NOTICE 文件详细说明了各组件许可的划分。致谢：WolvenKit；Cyber Engine Tweaks；y4rd13（CETBridge）；powzix/rarten（ooz Kraken 编解码器——未再分发任何专有的 Oodle）。

鸣谢