GodotLens 是一个 MCP（Model Context Protocol）服务器，让 AI 代理通过 Godot 内置的语言服务器、引擎和调试器来回答有关 GDScript 项目的问题，而不是自行猜测。它的核心原则是“把每一个判断都交给 Godot 本身”，因此返回的答案更可信。该工具要求 Godot 4.6 或更高版本（因为语言服务器在 4.5 和 4.6 发生了实质性变化），旧版本会被明确拒绝。
主要能力
- 理解代码：
gdscript_find按名称查找符号；gdscript_references和gdscript_hover解释符号的使用方式和类型。 - 编写代码：
gdscript_engine_api提供真实签名而非回忆的签名；gdscript_complete提供场景感知的补全建议；gdscript_validate在写入磁盘前检查提议内容。 - 同步文件：Godot 语言服务器不监视文件系统，编辑 .gd 文件后需要调用
gdscript_sync_file，否则会继续使用旧文本回答。 - 验证：
gdscript_diagnostics检查编译错误；scene_validate检查编译器无法看到的场景连线。 - 运行：
debug_run启动游戏并返回其打印输出。
使用方式
推荐通过 npx 安装，该包内置服务器，无运行时依赖。工具名称指示答案来源：gdscript_* 来自语言服务器；scene_* 和 project_config 运行引擎；debug_* 来自调试器。所有行和字符参数均采用 0 索引，与 LSP 一致。结果在关键处带有 verified 标志，若 verified: false 且诊断列表为空，表示 Godot 未回报，并不代表干净无误。
适用场景与限制
适用于需要 AI 代理准确理解 GDScript 项目、避免文本猜测、并在编辑后验证编译和场景连线的开发流程。已知限制包括：语言服务器只读取 .gd 文件，无法看到 .tscn 中按名称连线的信号处理器，重命名可能导致运行时失败而无编译错误；自动加载和输入动作名称是裸字符串，不会被验证；gdscript_references 在 4.6+ 上开销较大，建议优先使用 gdscript_references_in_file。项目采用 Apache License 2.0 许可。
