不止于MCP:Godot MCP Pro CLI模式的6种用法,适配任意LLM客户端

原创2026-11-12 17:03:361,942 阅读

不止于MCP:Godot MCP Pro CLI模式的6种用法,适配任意LLM客户端

Godot MCP Pro 是面向 Godot 4 游戏开发的高性能 MCP 服务器,为 AI 助手提供 187 个编辑器工具。除了标准的 MCP 协议,它还内置了一个常被忽略的 CLI 模式:只要你的 LLM 客户端能执行终端命令,就能绕过工具数量限制、零上下文开销地驱动 Godot 编辑器。本文带你了解它的 6 种实用玩法。

Godot MCP Pro 插件图标:187个工具连接 AI 与 Godot 4 编辑器

CLI 模式与 MCP 模式有什么区别?

Godot MCP Pro 的整体链路是:

AI 客户端 ←—stdio/MCP—→ Node.js 服务器 ←—WebSocket:6505—→ Godot 编辑器插件

而 CLI 模式走的是另一条直连通道:CLI 进程直接通过 WebSocket 连到编辑器插件,不经过 MCP 协议。编辑器端的 websocket_server.gd 中可以看到,插件会同时监听 6505-6514 端口区间:

  • 6505-6509:MCP 服务器专用
  • 6510-6514:CLI 工具专用
维度 MCP 模式 CLI 模式
依赖 客户端需支持 MCP 协议 只需能执行终端命令
上下文开销 需加载工具定义 接近零,按需 --help 发现
工具上限 受客户端工具数限制 不受限
命令入口 .mcp.json 配置 node build/cli.js <组> <命令>

两者共享同一套命令实现——编辑器侧由 command_router.gd 统一注册 26 个命令分组(project、scene、node、script、editor、input、runtime 等),CLI 只是换了个"入口"。

CLI 模式快速上手:3 步开始

1. 准备插件与服务器

git clone https://gitcode.com/gh_mirrors/go/godot-mcp-pro
# 将 addons/godot_mcp/ 复制进你的 Godot 项目 addons 目录
# 项目设置 → 插件 → 启用 Godot MCP Pro(见 plugin.cfg)
# 构建服务器(完整版包含 server/ 目录)
cd server && npm install && npm run build

插件信息可参考 plugin.cfg。

2. 确认前提条件

  • Godot 编辑器正在运行,且插件已启用
  • 服务器已完成构建(node build/setup.js install)
  • 6510-6514 端口区间有可用端口

3. 执行第一条命令

node /path/to/server/build/cli.js project info

CLI模式的6种用法:逐个场景拆解

用法一:三级 --help 渐进发现能力

CLI 最大的设计亮点是渐进式发现:不预加载 187 个工具定义,而是让模型自己"问路"。

node build/cli.js --help            # 第一级:查看所有命令组
node build/cli.js node --help        # 第二级:查看组内命令
node build/cli.js node add --help    # 第三级:查看命令参数

对新手来说这是最佳学习路径:先 --help 摸清版图,再逐个命令了解参数,最后执行。详见 README.md 的 CLI 章节。

用法二:让任意 LLM 客户端直接操控 Godot

只要客户端有终端(bash)工具,就能用 CLI 操作 Godot——不受 MCP 协议支持与否、工具数量上限的约束。官方推荐矩阵中,OpenCode、本地 LLM(LM Studio 等)的首选就是 Minimal 或 CLI 模式:

客户端 推荐模式
OpenCode Minimal 或 CLI
本地 LLM Minimal 或 CLI

完整的 12+ 客户端兼容清单见 README.md。

用法三:零上下文开销,拯救本地小模型

MCP 模式需要把工具定义塞进上下文窗口,工具一多,小模型容易"晕"。CLI 模式下,上下文里只有模型实际执行过的那几条命令,零预热成本,非常适合小上下文窗口(40 个工具以下表现明显更好)。

用法四:跑起来、停下来——日常开发循环

把常用操作变成终端习惯:

node build/cli.js scene play                          # 运行当前场景
node build/cli.js node add --type CharacterBody3D --name Player
node build/cli.js project info                        # 查看项目信息

改代码 → scene play → 看输出,比手动切回编辑器更快。中文文档 docs/README.zh.md 有同样说明。

用法五:Shell 脚本批量自动化

因为每条操作都是标准命令,可以串成脚本,实现"一键搭建场景":

#!/usr/bin/env bash
CLI="node /path/to/server/build/cli.js"
$CLI node add --type CharacterBody3D --name Player
$CLI node add --type Camera3D --name PlayerCamera
$CLI scene play

批量建节点、批量读项目信息、自动化冒烟检查,都是 shell 脚本的强项。

用法六:配合 Headless 工具搭测试验证流

CLI 还能与项目的 Headless 工具配合:用 run_headless_scene / run_headless_script 在独立 Godot 进程中跑项目自带的测试套件,取回 stdout/stderr 和退出码(见 CHANGELOG.md 的 v1.9.0 更新)。配合 run_test_scenario、assert_node_state 等测试工具,就能搭出一条 "AI 改代码 → CLI 触发 → headless 验证 → 报告结果" 的自动化 QA 流水线,这在纯 MCP 工具里很难实现。

小结

  • ✅ CLI 直连编辑器:走 6510-6514 端口 WebSocket,不依赖 MCP 协议
  • ✅ --help 渐进发现:三级帮助,零上下文开销
  • ✅ 适配任意 LLM 客户端:有终端就能用,不受工具上限约束
  • ✅ 可脚本化:日常循环、批量操作、headless 测试流都能覆盖

对于 MCP 支持不完整、工具数量受限或想追求最低开销的 LLM 客户端,CLI 模式是 Godot MCP Pro 里性价比极高的一条路。🚀

登录后查看全文
godot-mcp-pro