Godot MCP Auto Launcher

使用此技能自动启动Godot MCP服务器,确保在Godot项目启动时MCP工具可用。当需要确保MCP连接就绪或在项目启动时自动初始化MCP工具时触发。

44 stars 4 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add hhhh124hhhh/godot-mcp --skill godot-mcp-auto-launcher
Manual install
git clone --depth 1 https://github.com/hhhh124hhhh/godot-mcp.git /tmp/godot-mcp
mkdir -p ~/.claude/skills
cp -r /tmp/godot-mcp/.claude/skills/godot-skills/sub-skills/godot-mcp-auto-launcher ~/.claude/skills/godot-mcp-auto-launcher

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Godot MCP 自动启动器

## 技能目标

本技能负责自动检测和启动Godot MCP服务器,确保AI助手能够通过MCP工具与Godot编辑器通信。该技能提供完整的自动化流程,无需人工干预即可建立MCP连接。

## 使用场景

在以下情况中使用此技能:

1. **Godot项目启动时** - 确保MCP服务器随Godot编辑器一起启动
2. **MCP连接不可用** - 检测到MCP工具无法连接时自动启动服务器
3. **开发环境初始化** - 设置新的Godot+MCP开发环境
4. **MCP服务器意外关闭** - 自动重启意外终止的MCP服务器

## 操作流程

### 1. 检查MCP连接状态

首先检查MCP Node.js客户端是否已经连接到Godot:

```bash
# 使用Node.js脚本检查状态
node /mnt/d/godot-mcp/.claude/skills/godot-mcp-auto-launcher/scripts/start-mcp.js status

# 或者直接检查端口
lsof -i :9080  # 查看Godot是否在监听9080端口
```

### 2. 启动MCP客户端

如果MCP客户端未运行,使用以下命令启动:

```bash
# 使用Node.js启动脚本(推荐)
node /mnt/d/godot-mcp/.claude/skills/godot-mcp-auto-launcher/scripts/start-mcp.js start
```

**注意:** 启动前请确保Godot编辑器已打开且MCP插件已启用。

启动脚本会自动:
1. 检查MCP客户端是否已在运行
2. 构建MCP服务器(如果需要)
3. 启动MCP Node.js客户端
4. 保存进程PID以便后续管理

MCP客户端会自动尝试连接到Godot WebSocket服务器(端口9080)。

### 3. 验证连接

启动后验证MCP连接是否正常:

```bash
# 检查状态
node /mnt/d/godot-mcp/.claude/skills/godot-mcp-auto-launcher/scripts/start-mcp.js status

# 查看日志
 tail -f /tmp/mcp_launcher.log
```

### 4. 管理MCP客户端

停止MCP客户端:

```bash
node /mnt/d/godot-mcp/.claude/skills/godot-mcp-auto-launcher/scripts/start-mcp.js stop
```

重启MCP客户端:

```bash
node /mnt/d/godot-mcp/.claude/skills/godot-mcp-auto-launcher/scripts/start-mcp.js restart
```

显示帮助信息:

```bash
node /mnt/d/godot-mcp/.claude/skills/godot-mcp-auto-launcher/scripts/start-mcp.js --help
```

## 重要规则

### ⚠️ 禁止直接操作Godot文件

**绝对禁止**直接读取、写入或修改Godot项目文件(.tscn, .gd, .tres等)。所有与Godot文件的交互必须通过MCP工具完成。

✅ **正确做法**:使用MCP工具
Read the full skill on GitHub

Details

Skill name
godot-mcp-auto-launcher
Path
.claude/skills/godot-skills/sub-skills/godot-mcp-auto-launcher/SKILL.md
License
MIT
Repo updated
15 November 2025

FAQ

What does the Godot MCP Auto Launcher skill do?

使用此技能自动启动Godot MCP服务器,确保在Godot项目启动时MCP工具可用。当需要确保MCP连接就绪或在项目启动时自动初始化MCP工具时触发。

How do I install the Godot MCP Auto Launcher skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add hhhh124hhhh/godot-mcp --skill godot-mcp-auto-launcher. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Godot MCP Auto Launcher popular?

It lives in hhhh124hhhh/godot-mcp, which has 44 GitHub stars and 4 forks.

Related skills

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.