DesyncedMCP

用于 Desynced 模组开发的 MCP 服务器。让 AI 助手（Claude Code 或任何 MCP 客户端）直接访问游戏的 Lua API 参考、基础游戏源码、实时游戏日志和已安装的模组。

工具

静态（文件系统）

实时（lrdb 调试器链接，游戏以 -moddev 运行）

该链接使用 satoren lrdb 协议（换行分隔的 JSON-RPC，无 init）与 127.0.0.1:21110 通信。游戏的调试服务器只接受单个客户端的命令：当此服务器链接时，游戏内日志控制台会静默（输出被重定向到链接），VS Code 也无法附加。VM 仅在执行 Lua 时响应 eval，因此空闲菜单可能会超时。

Related MCP server: Roblox MCP Server

模拟桥接（配套模组）

game_eval 在游戏的 UI Lua VM 中运行，该 VM 禁止模拟变更。控制游戏（移动、部署、采矿、建造等）需要配套模组 Desynced MCP Bridge on the Steam Workshop，该模组将 FactionAction.MCPSimCmd 暴露到模拟上下文中。此服务器在没有该模组的情况下仍可用于只读工具（日志、状态、eval 读取、热重载）。

设置

npm install
npm test   # smoke test

在 Claude Code 中注册（项目范围）：

claude mcp add desynced --scope project -- node <path-to>/DesyncedMCP/server.js

配置（环境变量）

搜索基础游戏（可选）

游戏将其整个基础游戏作为 main.zip 放在模组文件夹中， 并且始终以压缩形式加载 — 在正常安装中永远不会解压。要让 search_game_source 和 read_game_file 看到基础游戏的 Lua，请使用任何 zip 工具将 main.zip 解压到工作区内的 main/ 文件夹中。这纯粹是为了开发方便；游戏既不需要也不使用解压后的副本。

游戏端要求

服务器本身在游戏外部运行 — 无需在游戏中安装任何内容。要生成日志，请使用以下 Steam 启动选项启动 Desynced：

-moddev -log

-moddev 启用模组开发者模式（F7 热重载、严格数据检查、日志控制台）；-log 写入此服务器读取的日志文件。

路线图

• deploy_mod：将工作区模组复制到游戏模组目录（替代手动复制步骤）

• 通过 lrdb 调试协议（-moddev 中的 localhost:21110）实现实时桥接：在运行中的游戏中 eval Lua、检查实体/阵营、触发 Debug.Reload()

• 通过 DesyncedModUploader 发布到创意工坊