戈多。网络MCP
Godot 4.6+编辑器插件，通过MCP公开实时Godot编辑器：项目状态、场景编辑、脚本分析、运行时控制、屏幕截图、日志和编辑器内部的客户端设置。
戈多。NET MCP是为需要当前编辑器状态而不是仅需要文件快照的客户端构建的。它提供MCP工具，用于读取项目运行状况、检查场景、编辑脚本、控制播放模式、捕获屏幕截图和设置客户端。C#分析通过插件内部的Roslyn语法层保持自包含，不需要外部主机进程。
为什么它存在
Godot编辑器的工作通常取决于文件未完全表示的状态：活动场景、当前停靠状态、运行时错误、编辑器UI、客户端配置、屏幕截图以及运行会话中是否有工具可用。戈多。NET MCP将这些状态和操作作为显式MCP工具公开，因此客户端可以在更改场景、脚本、资源或运行时状态之前检查编辑器。
亮点
- 编辑器原生MCP服务：本地MCP服务在Godot内运行，因此工具会观察当前的编辑器会话，而不是项目的过时副本。
- 编辑前检查：代理可以首先读取打开的项目、活动编辑器状态、最近的错误和可用工具，然后移动到文件、场景、脚本、运行时诊断或UI控件中。
- 戈多。NET支持：插件内部Roslyn支持C#语法诊断、C#文件读取/修补、，
.csproj支持、解决方案/项目检查和C#场景绑定审核。 - 视觉编辑器意识：代理可以捕获编辑器，检查可见或隐藏的控件，并通过Godot编辑器API激活停靠点、底部面板、控件和弹出窗口。
- 运行时自动化循环：运行/停止场景、启用运行时控制、注入输入、捕获帧和使用
system_runtime_step用于输入等待捕获工作流。 - 一键式客户端设置：Config页面帮助连接通用CLI和桌面代理，显示检测到的路径、配置目标、生成的JSON以及支持的安装/删除操作。
- 用户可扩展工具：drop
user_*GDScript工具进入custom_tools/；插件会发现并热重新加载它们，而无需重新构建插件。
截图
主页显示服务运行状况、服务地址、连接活动、自我诊断、重新加载控件、端口、日志级别和语言。“工具”页面列出了可用工具、启用状态和工具描述。Config页面为桌面和CLI客户端生成客户端设置，包括检测到的路径和可复制的配置。
代理人能做什么
了解项目和编辑器
system_help返回当前功能指南、推荐的第一步、屏幕截图指南、隐藏控件提示和模式事实。system_project_state总结了项目运行状况、文件计数、运行时状态、最近的错误、编译错误和可选的运行时运行状况。system_editor_state聚合编辑器工作区、检查器/文件系统选择、项目运行时摘要和运行时控制状态。system_plugin_reload提供稳定的代理可调用插件生命周期重新加载和同步插件文件后使用的新鲜度检查。
处理文件、场景和脚本
system_project_files涵盖了常见的项目文件系统操作。system_resource_reference_audit扫描.tscn/.tresUID+回退路径一致性和C#自定义资源脚本引用，包括之后可能存在的风险dotnet build成功。system_scene_validate,system_scene_analyze,system_scene_tree，以及system_scene_patch通过结构化工作流检查和编辑场景。system_script_analyze,system_script_patch，以及system_bindings_audit检查GDScript/C#结构和C#场景绑定。system_project_symbol_search和system_scene_dependency_graph提供索引项目查找和场景依赖关系视图。
操作编辑器和运行时
system_editor_control激活工作区、停靠区、底部面板、控件、弹出窗口，捕获编辑器UI，报告UI坐标映射，并可以分派控件本地左/右点击。system_editor_log读取、过滤或清除编辑器的“输出”面板。system_project_run,system_project_stop,system_runtime_diagnose,system_runtime_control，以及system_runtime_step(action=step|capture|input)提供场景执行、运行时诊断、屏幕截图和脚本输入循环。system_project_state(include_runtime_health=true)和system_editor_state揭露runtime_capabilities因此，代理可以将只读项目访问与启动、控制或捕获运行时会话的能力区分开来。system_userdata_maintenance列出并清理插件管理的编辑器/运行时捕获缓存user://godot_dotnet_mcp/默认情况下为模拟运行预览。
需求
- 戈多
4.6+与。NET支持。 - 使用的Godot项目。NET脚本在需要C#分析时启用。
- 具有MCP功能的客户端。配置页面目前针对的是常见客户端，包括Claude Code、Codex、Gemini CLI、OpenCode、Qwen Code、Claude Desktop、Cursor、Trae、Windsurf、Cline、Roo Code和Cherry Studio。
安装
Godot资源库
在Godot中打开您的项目，转到 AssetLib 选项卡，搜索 Godot .NET MCP，然后单击 Install。您也可以打开它 Godot资源库页面安装后，您的Godot项目应包含：
addons/godot_dotnet_mcp首选 Project Settings > Plugins，启用 Godot .NET MCP，打开 MCPDock，并从启动服务 Home 选项卡。
源工作流
对于开发或本地测试，请复制 addons/godot_dotnet_mcp/ 从该存储库到目标Godot项目的 addons/ 目录，然后以相同的方式启用插件。复制文件只会更新磁盘副本：已经运行的Godot编辑器会保留旧插件实例，直到您调用 system_plugin_reload(action="full_reload_plugin") 或禁用并重新启用插件。检查 /health, system_plugin_reload(action="get_freshness")，或 plugin_runtime_state(action="get_self_health") 为了 freshness.needs_lifecycle_reload 验证同步插件时。
快速启动
- 启用插件并打开
MCPDock > Home. - 确认服务地址，通常
http://127.0.0.1:3000/mcp. - 打开
MCPDock > Config，选择您的客户端，然后复制或写入生成的配置。 - 从代理人那里，打电话
system_help第一。 - 使用
system_project_state或system_editor_state在编辑之前。
基本检查：
GET http://127.0.0.1:3000/health
GET http://127.0.0.1:3000/api/tools
POST http://127.0.0.1:3000/mcp安全提示：默认情况下，本地HTTP服务器不返回通配符CORS标头。直接连接到的CLI和桌面MCP客户端 127.0.0.1 不需要CORS。基于浏览器的客户端必须明确地分配 GODOT_DOTNET_MCP_ALLOWED_CORS_ORIGINS 环境变量，使用逗号分隔的精确起源，例如 http://localhost:5173.
一分钟内完成建筑
戈多。NET MCP是一个自包含的Godot编辑器插件。HTTP服务器、MCP JSON-RPC路由、工具注册表、运行时状态、客户端配置、UI模型、本地化和Roslyn语法都支持实时内部 addons/godot_dotnet_mcp/.
暴露给代理的工具是有意面向任务的。该插件没有要求用户选择低级编辑器操作，而是将检查项目状态、编辑场景、阅读日志、捕获屏幕截图和控制运行时会话等常见工作组合成稳定的工具。对于想要检查每个工具的连接方式的用户，详细的实现链接仍然可以在“工具”页面中找到。
C#层以语法优先模式使用Roslyn的官方语法树API：它从 CSharpSyntaxTree 而无需加载完整的SemanticModel或项目工作区。这使得插件便携、轻量级，并与Godot编辑器运行时保持一致。
定制工具
在以下位置创建用户工具：
addons/godot_dotnet_mcp/custom_tools/每 .gd 文件应公开 handles(), get_tools()，以及 execute()。工具名称必须使用 user_ 前缀。有效工具出现在“工具”页面和MCP工具列表中的“系统工具”旁边。
文档
当前状态
源树当前跟踪 v1.0.0-pre3 开发工作，重点是运行时调试器桥消息稳定性和工具上下文助手修复。最新发布的预发布仍然 v1.0.0-pre2。参见 更改日志.md 查看各个版本的详细信息。