# Shadowforge

**Repository Path**: DamonT/shadowforge

## Basic Information

- **Project Name**: Shadowforge
- **Description**: 暗黑破坏神风格的ARPG游戏
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-21
- **Last Updated**: 2026-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Godot MCP 集成项目

这是一个集成了 Godot MCP（Model Context Protocol）的项目，让你可以通过 AI 助手与 Godot 游戏引擎进行交互。

## 前置要求

1. **Godot 游戏引擎** - 确保已经安装了 Godot 4.x
2. **Node.js 和 npm** - 用于运行 godot-mcp 服务器
3. **支持 MCP 的编辑器** - 如 Cursor、Claude Code 等

## 项目结构

```
game_godot/
├── .cursor/
│   └── mcp.json          # MCP 服务器配置文件
├── project.godot         # Godot 项目配置
├── main.tscn            # 主场景文件
├── main.gd              # 主脚本
└── README.md            # 本文件
```

## 快速开始

### 1. 安装 Node.js

如果你还没有安装 Node.js，请从 https://nodejs.org/ 下载并安装。

### 2. 在 Cursor 中启用 MCP

1. 打开 Cursor 编辑器
2. 打开本项目文件夹
3. 进入设置 → Features → MCP
4. 刷新 MCP 服务器列表，你应该能看到 "godot" 服务器
5. 确保 "godot" 服务器已启用

### 3. 使用 Godot MCP

现在你可以使用 Cursor 的 Agent 聊天来与 Godot 交互了！

可用的命令示例：

- **获取 Godot 版本**
  ```
  获取当前系统安装的 Godot 版本
  ```

- **启动 Godot 编辑器**
  ```
  在当前目录启动 Godot 编辑器
  ```

- **运行项目**
  ```
  运行当前 Godot 项目
  ```

- **创建新场景**
  ```
  创建一个带有 Sprite2D 节点的新场景
  ```

- **获取项目信息**
  ```
  获取当前 Godot 项目的详细信息
  ```

## 环境变量

如果 Godot 没有自动检测到，你可以在 mcp.json 中设置 GODOT_PATH：

```json
{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "C:\\Path\\To\\Your\\Godot.exe",
        "DEBUG": "true"
      }
    }
  }
}
```

## Godot MCP 功能

Godot MCP 提供以下功能：

- ✅ 启动/关闭 Godot 编辑器
- ✅ 运行/停止项目
- ✅ 捕获调试输出
- ✅ 获取项目信息
- ✅ 创建新场景
- ✅ 添加节点到场景
- ✅ 加载精灵图片
- ✅ 保存场景文件
- ✅ 管理资源 UID（Godot 4.4+）

## 故障排除

### Godot 未找到

- 确保 Godot 已正确安装
- 在环境变量中设置 GODOT_PATH
- 尝试完整的 Godot 可执行文件路径

### MCP 服务器未启动

- 确保 Node.js 和 npm 已正确安装
- 检查网络连接（首次运行需要下载 @coding-solo/godot-mcp）
- 查看 Cursor 控制台是否有错误信息

### 项目无法运行

- 确保 project.godot 文件存在
- 检查项目配置是否正确
- 尝试在 Godot 编辑器中手动打开项目

## 更多资源

- [Godot MCP GitHub 仓库](https://github.com/Coding-Solo/godot-mcp)
- [Godot 官方文档](https://docs.godotengine.org/)
- [MCP 协议文档](https://modelcontextprotocol.io/)

## 许可证

本项目使用 MIT 许可证。