AgentSkillsCN

godot-mcp-dap-start

为本项目启动或重启 Godot 编辑器的 MCP 服务器，以及调试器/DAP 端口。当 MCP 工具缺失、握手失败，或调试端口未正常开启时使用；其中包含单编辑器重启的工作流程与命令检查机制。

SKILL.md
--- frontmatter
name: godot-mcp-dap-start
description: Start or restart the Godot editor MCP server and debugger/DAP ports for this project. Use when MCP tools are missing, handshake fails, or the debug port is absent; includes a single-editor restart workflow and command checks.

Godot MCP + Debug Start

Overview

Ensure a single Godot editor instance is running, MCP is reachable, and the debug port is available for HPV and runtime inspection.

Workflow (Option A: clean restart)

  1. •Run the start script to ensure MCP is up:
    • •powershell -ExecutionPolicy Bypass -File scripts/ensure_godot_mcp.ps1
  2. •If MCP handshake fails or multiple editors are running, rerun with a forced restart:
    • •powershell -ExecutionPolicy Bypass -File scripts/ensure_godot_mcp.ps1 -ForceRestart
  3. •If you need the debug port for runtime inspection, rerun with:
    • •powershell -ExecutionPolicy Bypass -File scripts/ensure_godot_mcp.ps1 -StartGameForDebug

Success Criteria

  • •Port 9080 is listening and godot-mcp-cli --list-tools succeeds.
  • •When -StartGameForDebug is used, port 6007 is listening.

Notes

  • •Do not ask the user to click the MCP panel. Use the script first.
  • •Use a single Godot editor instance to avoid MCP conflicts.
  • •See references/commands.md for CLI and port checks.