Godot Sentinel MCP

# 🤖 Godot Sentinel MCP **Terminal-based AI assistant for Godot development via Model Context Protocol (MCP)** [](https://opensource.org/licenses/MIT) [](https://nodejs.org/) [](https://godotengine.org/) Sentinel bridges AI assistants (Claude, ChatGPT, etc.) with your Godot projects, enabling automatic error detection, context gathering, and intelligent code fixes—all from your terminal. ## ✨ Features - 🔍 **Automatic Error Detection** - Monitors Godot tests and runtime for errors - 🧠 **AI-Powered Fixes** - Generates and applies precise code patches - 🛡️ **Safe Patching** - Creates git branches for every change - 🎮 **Game Engine Aware** - Understands Godot 4 patterns and constraints - 🔧 **Terminal First** - No IDE required, pure command-line workflow - 🔌 **MCP Compatible** - Works with any MCP-enabled AI assistant ## 🚀 Quick Start ```bash # Install and setup npm install -g godot-sentinel-mcp cd your-godot-project sentinel init # Start the MCP server sentinel server # In another terminal, use with Claude Code or other MCP client claude-code # Now has access to your Godot project! ``` ## 📹 Demo ```bash $ sentinel test 🧪 Running tests... ❌ Tests failed 🚨 Error: Invalid call 'get_damage' in fighter.gd:45 $ # Ask your AI assistant: "What's wrong with my game?" # AI can now see the error, read your code, and suggest fixes! ``` ## 🛠️ How It Works 1. **Monitor** - Watches your Godot project for test failures and runtime errors 2. **Parse** - Extracts structured error information from Godot logs 3. **Expose** - Provides MCP tools for AI assistants to access your project 4. **Fix** - AI can read context, propose changes, and apply patches safely 5. **Verify** - Re-runs tests to ensure fixes work ## 🎯 Perfect For - **Godot developers** who want AI-powered debugging - **Terminal enthusiasts** who prefer command-line workflows - **Teams** wanting automated error detection and fixing - **Streamers/content creators** doing live Godot development ## 📚 Documentation - [Installation Guide](docs/installation.md) - [MCP Integration](docs/mcp-setup.md) - [Godot Project Setup](docs/godot-setup.md) - [API Reference](docs/api.md) - [Troubleshooting](docs/troubleshooting.md) ## 🤝 Contributing We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. ### Roadmap - [ ] Support for Godot 3.x - [ ] Integration with more MCP clients - [ ] Visual Studio Code extension - [ ] CI/CD pipeline integration - [ ] Performance profiling tools ## 📄 License MIT License - see [LICENSE](LICENSE) for details. ## 🙏 Acknowledgments - [Anthropic](https://anthropic.com) for the MCP protocol - [Godot Engine](https://godotengine.org) community - [gdUnit4](https://github.com/MikeSchulze/gdUnit4) testing framework --- **⭐ Star this repo if it helps your Godot development!**