mcp-recovery

Recovers failed Mineflayer server instances by automatically restarting them and restoring their state from disk.

Updated Dec 15, 2025

Search Tags:#debugging #troubleshooting #mcp #godot #recovery #connection issues

Ready to run

npx skills add https://github.com/OpenSourceSam/v2_heras_garden --skill mcp-recovery-opensourcesam

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: mcp-recovery
Source: https://github.com/OpenSourceSam/v2_heras_garden/tree/main/.claude/skills/mcp-recovery
Command: npx skills add https://github.com/OpenSourceSam/v2_heras_garden --skill mcp-recovery-opensourcesam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill resolves common issues where the Godot MCP (Multi-process Communication Protocol) server becomes unresponsive or inaccessible, preventing game development workflows.

Core Features & Use Cases

Automated Troubleshooting: Diagnoses and resolves MCP connection problems, including port conflicts and unresponsive processes.
Recovery Levels: Offers tiered recovery options from light restarts to full system resets.
Use Case: When your Godot editor fails to connect to the MCP server, or commands time out, this Skill can automatically restart the necessary services and clear conflicting processes to restore functionality.

Quick Start

Run the heavy recovery procedure to restart Godot and ensure the MCP port is available.

Frequently Asked Questions about mcp-recovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I fix a Godot MCP server connection that is unresponsive or timing out?▼

To fix an unresponsive Godot MCP server connection, you need to automate recovery by running PowerShell scripts that diagnose connection issues, restart necessary services, and clear conflicting processes to restore MCP availability.

Why does my Godot MCP connection fail when port 9080 is not listening?▼

Your Godot MCP connection fails when port 9080 is not listening due to port conflicts or unresponsive processes. Automated troubleshooting scripts can resolve these conflicts by managing processes and restarting the server to restore port availability.

How do I resolve MCP port conflicts caused by multiple Godot instances?▼

To resolve MCP port conflicts caused by multiple Godot instances, you can use a heavy recovery procedure that clears conflicting processes and restarts the Godot editor, ensuring the MCP port is available and functional.

Can I use PowerShell scripts to automate Godot MCP server recovery on Windows?▼

Yes, you can use PowerShell scripts to automate Godot MCP server recovery on Windows. The scripts handle process management and service restarts, offering tiered recovery options from light restarts to full system resets to ensure MCP availability.

What is the best way to restore Godot MCP connection when commands stop working?▼

The best way to restore Godot MCP connection when commands stop working is to run an automated heavy recovery procedure. This restarts Godot, clears conflicting processes, and ensures the MCP port is available for game development workflows.