godot-mcp: Skill for Claude Code

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

godot-mcp-auto-launcher is a skill for Claude Code from hhhh124hhhh/godot-mcp. It costs 52 tokens per session (1,354 once invoked), scanned A, original, MIT.

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.

In plain words
What is it for?
Use it to check the connection, start or stop the Node.js client, restart it, build the server when needed, and inspect its logs.
Why use it?
It helps restore the connection when the MCP client is not running or has stopped, so the assistant can communicate with Godot.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

This is hhhh124hhhh/godot-mcp's own configuration. It tells Claude Code how to work on godot-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything godot-mcp configures →

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.

agentmods badge for godot-mcp-auto-launcher

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.

agentmods 80×15 button for godot-mcp-auto-launcher

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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00052 $0.01354
Opus 5 $0.00026 $0.00677
Sonnet 5 $0.00010 $0.00271
Haiku 4.5 $0.00005 $0.00135

Measured 12d ago against content hash 612afbdacd3c, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, 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 12d 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连接。

使用场景

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

  1. Godot项目启动时 - 确保MCP服务器随Godot编辑器一起启动
  2. MCP连接不可用 - 检测到MCP工具无法连接时自动启动服务器
  3. 开发环境初始化 - 设置新的Godot+MCP开发环境
  4. 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插件已启用。

启动脚本会自动:

  1. 检查MCP客户端是否已在运行
  2. 构建MCP服务器(如果需要)
  3. 启动MCP Node.js客户端
  4. 保存进程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资源文件

自动化启动的最佳实践

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

故障排除

问题:端口已被占用

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

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

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

# 然后重新启动
npm run dev

问题:MCP工具连接失败

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

  1. 检查防火墙设置,确保端口9080未被阻止
  2. 确认MCP服务器日志中没有错误
  3. 检查Godot插件配置,确认WebSocket地址正确
  4. 尝试重启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.

  1. 12d 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 (42 stars, last pushed 10mo ago), licensed MIT. It adds 52 tokens to every session and 1,354 once invoked, about $0.0003 per session on Opus 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.

Related

Other skills, from other repositories

gameobject-component-destroy

Destroy one or more Components from a target GameObject. Missing (null) components are skipped — they cannot be destroyed. Use 'gameobject-find' and 'gameobject-component-get' to identify the components first.

IvanMurzak/Unity-MCP · 49 tokens

unity-version-split

Split a C# file into Unity 6.5+ and pre-Unity 6.5 variants. Use when a file needs different implementations for different Unity versions due to API changes (e.g., EntityId vs int, GetEntityId vs GetInstanceID).

IvanMurzak/Unity-MCP · 59 tokens

godot-signals-groups

Build event-driven, decoupled Godot 4.7 gameplay with signals and node groups: declare and emit custom signals, connect with Callables (incl. bind/one-shot), and broadcast to many nodes via groups and callgroup. Use when wiring node communication in a Godot project, replacing tight references with signals…

gamedev-skills/awesome-gamedev-agent-skills · 95 tokens

motion

How an agent turns a character mesh into a usable animated FBX — and how to judge whether the result is shippable.

OpenDCAI/GameFactory-3A · 0 tokens

unity-addressables

Manage Addressables groups, entries, profiles and content builds (com.unity.addressables, reflection-based).

Besty0728/Unity-Skills · 25 tokens

threejs-exposure-color-grading

Build a measured exposure and grading path in Three.js. Use for a 64x36 encoded luminance meter, asynchronous readback, weighted log-average exposure, asymmetric adaptation, single tone-map ownership, and a generated 32-cube post-tone-map LUT.

scottstts/Threejs-Awesome-Graphics-Agent-Skills · 60 tokens