你在 DEX 点选对象  →  AI 立刻知道是哪个对象
AI 决定操作        →  你的 DEX 界面自动跳转并高亮

git clone https://github.com/986mn/roblox-AI-mcp.git
cd roblox-AI-mcp
npm install --ignore-scripts --no-package-lock
npm run build

node dist/index.js < /dev/zero

MCP Server started and connected via stdio.
[Router] Loaded 34 HTTP route(s), 1 WS route(s) + WS fallback.
[Primary] MCP Bridge listening on port 16384 (WebSocket + HTTP)

getgenv().BridgeURL = "localhost:16384"                     -- 本机
-- getgenv().BridgeURL = "192.168.1.100:16384"             -- 局域网
-- getgenv().BridgeURL = "https://xxx-16384.app.github.dev" -- Codespaces

loadstring(game:HttpGet("http://" .. getgenv().BridgeURL .. "/script.luau"))()

{
  "mcpServers": {
    "roblox-ai-mcp": {
      "command": "node",
      "args": ["/path/to/roblox-AI-mcp/dist/index.js"]
    }
  }
}

-- 直接加载，零配置
loadstring(game:HttpGet("https://raw.githubusercontent.com/986mn/roblox-AI-mcp/main/dex-full/dex_AC.lua"))()

getgenv().DEX_URL = "https://raw.githubusercontent.com/986mn/wg/main/dex.lua"
loadstring(game:HttpGet("https://raw.githubusercontent.com/986mn/roblox-AI-mcp/main/dex-mcp/dex_mcp_B.lua"))()

cat dex.lua dex-mcp/dex_mcp_A.lua > dex_custom.lua

① 你在 DEX 里点中 workspace.Map.NPC
   ↓ 点【→ MCP】按钮（或 Ctrl+Shift+M）
② AI 调用 dex-events 工具
   → 收到 ["game.Workspace.Map.NPC"]
③ AI 调用 get-instance-properties
   → 知道这是 Model，有 Humanoid，Health=100
④ AI 调用 dex-select
   → 你的 DEX 界面自动跳到该对象，属性面板展开
⑤ AI 调用 execute
   → Health 改成 0

-- AI 说「帮你选中所有 NPC」
getgenv().DEX.Select({
    "game.Workspace.Map.NPC",
    "game.Workspace.Map.NPC2",
}, true)
-- 你的 DEX 界面同步高亮这两个

local D = getgenv().DEX

-- 读
D.Snapshot()                          -- 当前选中快照（含路径、类名、位置、血量）
D.Tree("game.Workspace", 3, 200)      -- 实例树（深度, 上限）
D.Props("game.Workspace.NPC")         -- 属性 + Attributes + CollectionService 标签
D.Source("game.ReplicatedStorage.X")  -- 反编译源码
D.Info(node)                          -- 单个节点信息
D.Resolve("game.Workspace.NPC")       -- 路径 → Instance

-- 写
D.Select({"game.Workspace.NPC"})          -- 设置选中
D.Select({p1, p2}, true)                  -- 追加选中
D.SetProp(path, "Health", "0")            -- 改属性
D.SetProp(path, "CFrame", "lua:CFrame.new(0,50,0)")  -- lua: 前缀求值
D.Run("return 1+1")                       -- 执行 Luau
D.App("Explorer", true)                   -- 开面板
D.App("Explorer", false)                  -- 关面板
D.Refresh()                               -- 刷新界面

-- 队列
D.PushPending("reason")               -- 当前选中入队
D.TakePending()                       -- 取走并清空

-- 原生模块直通（高级）
D.Main / D.Apps / D.Explorer / D.Properties / D.ScriptViewer / D.Console
D.nodes / D.selection / D.env / D.API / D.RMD / D.Lib

local Q = getgenv().DEX_QUEUE

Q.Take()          -- 取走队列并清空
Q.Peek()          -- 只看不清空
Q.Send("reason")  -- 手动发送当前选中
Q.Selected()      -- 当前选中的路径数组
Q.Count()         -- 队列长度
Q.Button()        -- 重建按钮
Q.Select(paths)   -- 选中（C 版本也支持）

game.Workspace.Map.NPC                          -- 普通
Workspace.Map.NPC                               -- 省略 game 前缀
game:GetService("ReplicatedStorage").Mods       -- 服务
game.Workspace:GetChildren()[3]                 -- 重名索引
game.Workspace["奇怪 名字"]                      -- 特殊字符

{
  "type": "selection",
  "reason": "button",
  "time": "12:00:00",
  "paths": ["game.Workspace.Map.NPC"]
}

GET  /                       仪表盘（Console / Executor / Tools / Scripts）
GET  /script.luau            加载器
GET  /api/status             状态
GET  /api/tools              工具目录
POST /api/tool               执行工具
GET  /api/scripts            脚本列表
GET  /api/client-logs        客户端日志
GET  /api/screenshot         截图
POST /register               客户端注册
GET  /poll                   HTTP 轮询
POST /respond                响应
GET  /script-sources         脚本源
WS   /mcp-relay              主从中继

roblox-AI-mcp/
├── dex-full/                    ⭐ 已拼接的完整版（直接用）
│   ├── dex_AC.lua               原版 DEX + API + 按钮（510 KB）
│   ├── dex_A.lua                原版 DEX + API（494 KB）
│   └── dex_C.lua                原版 DEX + 按钮（493 KB）
├── dex-mcp/                     纯补丁（自己拼）
│   ├── dex_mcp_A.lua
│   ├── dex_mcp_B.lua
│   ├── dex_mcp_C.lua
│   └── DEX_README.md
├── src/
│   ├── http/
│   │   ├── dex-store.ts         DEX 事件存储（200 条环形缓冲）
│   │   └── routes/dex/
│   │       ├── event.ts         POST/GET /dex/event
│   │       └── events.ts        GET/DELETE /dex/events
│   ├── tools/impl/dex/
│   │   ├── dex-events.ts
│   │   ├── dex-select.ts
│   │   └── dex-snapshot.ts
│   ├── bridge/                  主从中继、客户端注册
│   ├── http/                    路由、仪表盘
│   └── semantic/                向量搜索（Ollama）
├── connector.luau               注入客户端的 Luau（已打协议补丁）
├── .devcontainer/               Codespaces 自动部署
├── keepalive.sh                 防休眠 + 服务自愈
├── push-to-github.sh            一键推送（自动建仓库）
└── docs/                        各客户端配置指南

https://<codespace-name>-16384.app.github.dev/

getgenv().BridgeURL = "https://<codespace-name>-16384.app.github.dev"
loadstring(game:HttpGet(getgenv().BridgeURL .. "/script.luau"))()

ssh -L 16384:localhost:16384 user@target-machine