feat(mcp): 增加游戏内方块调试桥接

新增 stdio MCP server 和 mcp 子命令,通过调试会话状态文件连接内置 TCP bridge,并提供 place_block 工具。

Bridge 将请求投递到服务端 System 的游戏线程执行,限制请求大小与队列长度,并按会话端口安全清理状态文件和连接。
This commit is contained in:
2026-07-21 21:04:45 +08:00
parent 94b1b9a1f5
commit 1a7bc6aca1
15 changed files with 1375 additions and 11 deletions

View File

@@ -54,7 +54,25 @@ emod-cli debug --new # 创建全新调试存档
2. 清理运行时旧包链接
3. 注册调试 MOD 并链接用户 MOD 目录
4. 准备开发世界(含自动加入游戏配置)
5. 启动游戏进程挂载 IPC 日志热重载
5. 启动游戏进程;启用内置调试 MOD 时挂载 IPC 日志热重载与 debug MCP bridge
### mcp
启动标准 stdio MCP server让 AI 连接正在运行的 `debug` 会话并在游戏内放置方块。`mcp` 命令不会启动游戏;必须先为同一项目启动启用了内置调试 MOD 的 `debug`
```bash
# 终端 1启动游戏并注入 debug MCP bridge
emod-cli debug --path <项目路径>
# MCP 客户端配置:启动 stdio MCP server
emod-cli mcp --path <项目路径>
```
工具示例:
```text
place_block {"x":0,"y":5,"z":0,"name":"minecraft:stone"}
```
### release