What is godot-mcp-auto-launcher?

An automatic launcher and connection checker for the Godot MCP server. Godot is a game-development program, and MCP lets an AI assistant communicate with the editor.

Use it to check the connection, start or stop the Node.js client, restart it, build the server when needed, and inspect its logs.

It helps restore the connection when the MCP client is not running or has stopped, so the assistant can communicate with Godot.

How hhhh124hhhh/godot-mcp configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to hhhh124hhhh/godot-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/hhhh124hhhh/godot-mcp/main/.claude/skills/godot-skills/sub-skills/godot-mcp-auto-launcher/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/hhhh124hhhh/godot-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/hhhh124hhhh/godot-mcp/godot-mcp-auto-launcher/github.svg)](https://agentmods.dev/skills/hhhh124hhhh/godot-mcp/godot-mcp-auto-launcher)

Your own site

<a href="https://agentmods.dev/skills/hhhh124hhhh/godot-mcp/godot-mcp-auto-launcher"><img src="https://agentmods.dev/badge/skills/hhhh124hhhh/godot-mcp/godot-mcp-auto-launcher/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/hhhh124hhhh/godot-mcp/godot-mcp-auto-launcher"><img src="https://agentmods.dev/badge/skills/hhhh124hhhh/godot-mcp/godot-mcp-auto-launcher.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 52 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,354 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00052	$0.01354
Opus 5.5	$0.00021	$0.00542
Sonnet 5.5	$0.00010	$0.00271
Haiku 4.5	$0.00005	$0.00135

Measured 2mo ago against content hash 612afbdacd3c, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

godot-mcp-auto-launcher scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/start-mcp.js), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s http://localhost:9080 > /dev/null

.claude/skills/godot-skills/sub-skills/godot-mcp-auto-launcher/SKILL.md · 181 lines

How it starts

The opening of the file, as written. The whole thing — 181 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Godot MCP 自动启动器

技能目标

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

使用场景

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

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

操作流程

1. 检查MCP连接状态

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

# 使用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客户端未运行，使用以下命令启动：

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

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

启动脚本会自动：

检查MCP客户端是否已在运行
构建MCP服务器（如果需要）
启动MCP Node.js客户端
保存进程PID以便后续管理

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

3. 验证连接

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

# 检查状态
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客户端：

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

重启MCP客户端：

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

显示帮助信息：

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

重要规则

⚠️ 禁止直接操作Godot文件

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

✅ 正确做法：使用MCP工具

使用 create_node 创建节点
使用 update_node_property 修改节点属性
使用 create_script 创建脚本
使用 get_script 读取脚本内容

❌ 错误做法：直接操作文件

不要使用Read工具读取.tscn文件
不要使用Edit工具修改.gd文件
不要使用Write工具创建Godot资源文件

自动化启动的最佳实践

错误处理：启动失败时提供清晰的错误信息
日志记录：记录启动过程中的所有关键步骤
状态检查：在启动前后都进行状态验证
优雅关闭：提供关闭服务器的机制

故障排除

问题：端口已被占用

如果端口9080已被其他应用占用：

# 查找占用端口的进程
lsof -i :9080

# 如果是Godot MCP的旧实例，先终止它
kill -9 <PID>

# 然后重新启动
npm run dev

问题：MCP工具连接失败

如果MCP工具无法连接到服务器：

检查防火墙设置，确保端口9080未被阻止
确认MCP服务器日志中没有错误
检查Godot插件配置，确认WebSocket地址正确
尝试重启Godot编辑器

Read the full file on GitHub · 181 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 181 lines · 52 tokens per session scan A 612afbdacd3c

Subscribe to this mod's changes

godot-mcp-auto-launcher is a skill published in the GitHub repository hhhh124hhhh/godot-mcp (43 stars, last pushed 11mo ago), licensed MIT. It adds 52 tokens to every session and 1,354 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Building agents Game development

godot-mcp-auto-launcher next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
godot-mcp-auto-launcherhhhh124hhhh/godot-mcp	Skill	43	11mo ago	MIT	A	52	Claude Code
playtest-reportDonchitos/Claude-Code-Game-Studios	Skill	36k	19d ago	MIT	A	20	Claude Code
godot-signals-groupsgamedev-skills/awesome-gamedev-agent-skills	Skill	6.9k	10d ago	Apache-2.0	A	95	Claude Code
scenario-unreal-gameplayscenario-labs/skills	Skill	3.2k	yesterday	MIT	A	121	Claude Code
motionOpenDCAI/GameFactory-3A	Skill	1.0k	9d ago	Apache-2.0	A	0	Claude Code, Codex
unity-addressablesBesty0728/Unity-Skills	Skill	1.9k	yesterday	MIT	A	25	Claude Code, Codex
unity-manual-componentBesty0728/Unity-Skills	Skill	1.9k	yesterday	MIT	A	36	Claude Code, Codex

godot-mcp: Skill for Claude Code