LuoxuanLove/godot-dotnet-mcp

English | 中文

| 首页 | 工具 | 配置 | |---|---|---| |  |  |  | # to Simplified Chinese." So, I must produce a Chinese translation. Godot .NET MCP 是一个用于 Godot 4.6+ .NET 项目的编辑器内 MCP 插件。它直接在 Godot 编辑器内部运行，向支持 MCP 的客户端提供实时的项目上下文，包括编辑器状态、当前场景、选中的节点、运行信息、诊断信息和截图。 MCP 服务内置于 Godot 插件中。启用插件并从 Dock 启动服务即可，无需运行任何额外的后台进程。 ## 存在意义 一个 Godot 项目不仅仅是 `.tscn`、`.tres` 和脚本文件的堆砌。 你正在查看的场景、当前选中的节点、编辑器输出、游戏运行时的视图与状态、最近的错误以及插件配置，都会影响一次修改应该是什么样子。Godot .NET MCP 收集这些编辑器上下文并将其提供给 MCP 客户端，这样它们就不再需要仅凭目录快照来猜测项目状态了。 如果你的工作主要发生在 Godot 编辑器和游戏运行时，而不仅仅是代码文件中，那么这个插件将会非常有用。 ## 亮点特性 | | 功能 | 作用 | | :---: | :--- | :--- | | 🎛️ | **编辑器内本地 MCP 插件** | MCP 服务直接由 Godot 插件提供，无需额外后台进程。 | | 🚀 | **安装简单** | 可从 Godot 资源库安装，或直接将 `addons/godot_dotnet_mcp/` 源文件复制到项目中。 | | 🔄 | **最新 GitHub 代码** | 通过常规编辑器或 GUI 文件更新保持复制的插件为最新，或在适当时通过 MCP 项目文件工具更新。 | | 🎮 | **实时 Godot 编辑器上下文** | 为您的 Agent 提供当前场景、选中的节点、Dock 状态、日志、运行信息和编辑器截图。 | | 🌳 | **场景与资源工作流** | 帮助检查场景树、资源引用、依赖关系和场景结构问题。 | | ▶️ | **游戏运行时支持** | 启动和停止场景、检查运行时诊断、执行输入、捕获游戏运行时视图。 | | 🔎 | **基于 Roslyn 的 C# 支持** | 利用插件内置的 Roslyn 语法检查来读取 C# 脚本，侧重于结构识别和诊断边界。 | | ⚙️ | **客户端配置** | 从插件配置页面为常见 MCP 客户端生成或复制连接设置，并能一键打开当前项目。 | | 🧰 | **用户扩展** | 可选地从 `custom_tools/` 热加载 `user_*` GDScript 工具。 | | 📚 | **MCP 资源与提示** | 暴露项目信息、诊断数据、场景/脚本/资源读取以及引导式工作流提示。 | ## 安装说明 ### 从 Godot 资源库安装 1. 在 Godot 中打开您的项目。 2. 打开 `AssetLib` 选项卡。 3. 搜索 `Godot .NET MCP`。 4. 安装插件。 5. 前往 `项目设置 > 插件` 并启用 `Godot .NET MCP`。 6. 打开 `MCPDock` 并从 `首页` 启动服务。 ### 从源码安装 将插件源目录复制到您的 Godot 项目中： ``` addons/godot_dotnet_mcp ``` 然后在 `项目设置 > 插件` 中启用它。 ## 首次使用 1. 在 Godot 4.6+ .NET 项目中安装并启用插件。 2. 打开 `MCPDock`。 3. 从 `首页` 启动 MCP 服务。 4. 从配置页面生成或复制您的 MCP 客户端配置。 5. 返回客户端并连接到服务，然后让其读取当前 Godot 项目状态。 ## 文档 - [中文 README](README.zh-CN.md) - [更新日志](CHANGELOG.md) - [文档概述](docs/概述.md) - [安装与发布](docs/架构/安装与发布.md) - [用户扩展](docs/模块/用户扩展.md) ## 作者的话 虽然我还只是一名学生，但我对做游戏充满热情。我曾经独自一人用老方法写过一个完整的节奏游戏项目。说实话，与代码细节和调试斗争是痛苦的。 在 AI 时代，一切都变了，代码变得廉价。在发现了诸如 Agent 和 MCP 这样的伟大概念后，我欣喜若狂。我希望 AI 能够简单快捷地将我的想法变为现实，并自主完成设计、开发、验证以及所有其他工作。 在短暂尝试了一些其他 Godot MCP 之后，我放弃了它们。面对我不断变化的游戏开发需求，现有的 MCP 就像只能拧固定螺丝的螺丝刀。它们远远不够用。 所以我决定自己编写这个 MCP 插件，并在我构建自己的游戏时亲自使用它。这个优秀的插件将在我真实的工作中得到实战检验；我会先踩坑，打磨它，并为你修复问题。 试试 Godot .NET MCP 吧。它将成为你的 Agent 与你的游戏项目之间最紧密的连接。 顺便一提，像 oh-my-openagent 这样优秀的开源项目是我所钦佩并努力追赶的目标。它的作者们用 AI 建造了一座宏伟的宫殿，然后用严谨的工作流程打磨每一个细节。通过学习 oh-my-openagent 的工作流程，我学到了很多。 同时，我也正在使用 opencode + oh-my-openagent 来开发这个插件。这个项目 100% 的代码都是由 AI 直接生成的。我实际上并不懂 GDScript。但我保证：这份 README 是由我本人审阅并大量重写的。 这听起来很傲慢吗？也许吧。如果你有一个更厉害的实现想法，请提交 PR。非常欢迎！ ## 许可证 MIT。参见 [LICENSE](LICENSE)。

标签：AI辅助开发, AI集成, Godot .NET, Godot引擎, MCP协议, .NET框架, OISF, 人工智能代理, 场景编辑, 多人体追踪, 实时接口, 客户端配置, 截图工具, 插件开发, 日志管理, 游戏开发, 编辑器扩展, 编辑器插件, 脚本分析, 节点操作, 诊断功能, 软件开发, 运行时控制, 项目状态管理