🤖 Godot Sentinel MCP

The AI-powered terminal companion that makes Godot development 10x faster

License: MIT Node.js Godot MCP

"Finally, an AI that understands my Godot project!"

🚀 What is Sentinel?

Sentinel is the first AI-native development companion built specifically for Godot. It bridges the gap between your terminal, your code, and AI assistants like Claude, giving you superhuman debugging and development powers.

No more:

❌ Copy-pasting error messages to ChatGPT
❌ Manually describing your project structure to AI
❌ Switching between IDE and AI chat windows
❌ Broken fixes that don't understand Godot patterns

Instead:

✅ AI sees your errors in real-time
✅ Instant access to your entire project context
✅ Smart fixes that understand game development
✅ Safe, git-backed automatic patching

🎯 The Problem We Solve

$ godot --headless test.gd ERROR: Invalid call 'get_damage' in fighter.gd:45 # Now what? # 1. Open IDE # 2. Find line 45 # 3. Copy error to AI chat # 4. Explain project context # 5. Get generic solution # 6. Apply manually # 7. Test again # 8. Repeat...

$ sentinel fix 🔧 Running fix loop... 📖 Gathering context... 🤖 AI found the issue... 🔨 Applied patch on branch ai/fix-20241210 ✅ Tests now passing! 🎮 Launching game... # Done in 30 seconds!

✨ Features

🧠 AI-Native Architecture

MCP Integration: Works with Claude, ChatGPT, and any MCP-compatible AI
Context-Aware: AI sees your entire project structure and recent changes
Godot-Specific: Understands game development patterns and constraints

🔍 Intelligent Error Detection

Real-time Monitoring: Catches errors the moment they happen
Smart Parsing: Extracts precise file locations and context from Godot logs
Multi-Source: Monitors tests, runtime, and optional editor plugin

🛡️ Safe & Professional

Git-Based Patching: Every fix creates a new branch automatically
Rollback Ready: Easy to undo any change with standard git commands
Security First: File access restricted to project directory only

⚡ Terminal-First Workflow

No IDE Required: Works with any editor or pure command line
Scriptable: Integrate into CI/CD, git hooks, or custom workflows
Minimal Dependencies: Just Node.js and Godot

🎬 Demo

Basic Error Fixing

# Your game has a bug $ sentinel test 🧪 Running tests... ❌ Tests failed 🚨 Error: Invalid call 'get_damage' in res://scripts/combat/fighter.gd:45 # Ask your AI assistant (Claude, etc): "What's wrong with my Godot game?" # AI Response: "I can see the error in your fighter.gd file. # The function should be 'calculate_damage()' not 'get_damage()'. # Let me fix that for you..." # AI applies the fix automatically: ✅ Fixed function name in fighter.gd ✅ Tests now passing ✅ Created branch: ai/fix-20241210-143022

Watch Mode (Live Development)

$ sentinel watch 👀 Watching for file changes... 📝 Changed: scripts/player.gd 🔧 Auto-fixing... ✅ Applied 2 fixes automatically 🎮 Game still running perfectly

Project Understanding

# AI can instantly understand your project: "Show me the structure of my combat system" # AI Response: "Your combat system has: # - Fighter class (res://scripts/combat/fighter.gd) # - State machine (res://scripts/combat/state_machine.gd) # - 3 movesets in data/movesets/ # - 12 unit tests with 2 currently failing..."

🚀 Quick Start

1. Install Sentinel

npm install -g godot-sentinel-mcp

2. Setup Your Godot Project

cd your-godot-project sentinel init # Creates .env with your project configuration

3. Start the MCP Server

sentinel server # Runs on http://localhost:8787

4. Connect Your AI Assistant

With Claude Code:

# AI now has access to your project! # Try: "What errors are in my Godot game?"

With other MCP clients: See MCP Setup Guide

5. Start Coding!

# Terminal 1: Development sentinel watch # Auto-fix on file changes # Terminal 2: Testing sentinel test # Run tests anytime # Terminal 3: AI Assistant # Ask questions, get fixes, understand your code

🛠️ Installation

Prerequisites

Node.js 18+
Godot 4.3+ in your PATH
Git (for patch management)
gdUnit4 (for testing) - Install Guide

Install Options

Option 1: NPM (Recommended)

npm install -g godot-sentinel-mcp

Option 2: From Source

git clone https://github.com/Snack-JPG/Godot-Sentinel-MCP.git cd Godot-Sentinel-MCP npm install npm run build npm link

Option 3: Docker

docker run -v $(pwd):/project snackjpg/sentinel-mcp

🎮 MCP Tools Reference

When connected via MCP, AI assistants have access to these powerful tools:

Tool	Description	Example Use
`run_tests()`	Execute Godot tests	"Run my tests and show failures"
`get_context(file, line)`	Get code around specific location	"Show me the context around this error"
`read_file(path)`	Read any project file	"What's in my player script?"
`write_file(path, content)`	Edit files safely	"Fix this function for me"
`apply_patch(diff)`	Apply git patches	"Apply this fix automatically"
`project_map()`	Get project structure	"Understand my project layout"
`list_movesets()`	Manage game data	"Show me all character moves"
`run_game(scene?)`	Launch game with monitoring	"Test this scene"

🏗️ Architecture

┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐ │ AI Assistant │ │ Sentinel MCP │ │ Godot Project │ │ (Claude, etc.) │◄──►│ Server │◄──►│ + gdUnit4 │ └─────────────────┘ └──────────────────┘ └─────────────────┘ │ │ │ │ MCP Protocol │ Shell Commands │ Optional │ (HTTP/WebSocket) │ Log Parsing │ Plugin │ │ Git Operations │ ▼ ▼ ▼ ┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐ │ Your Terminal │ │ File System │ │ Runtime Events │ │ │ │ ~/.sentinel/ │ │ (Real-time) │ └─────────────────┘ └──────────────────┘ └─────────────────┘

Core Components

MCP Server: Exposes Godot project via Model Context Protocol
Godot Shell Adapter: Runs tests and games, captures output
Error Parser: Extracts structured data from Godot logs
Patcher: Safely applies AI-generated fixes via git
Context Provider: Gathers code and project information
Optional Emitter Plugin: Real-time error reporting from Godot

📚 Documentation

Getting Started

Installation Guide - Detailed setup instructions
First Project - Tutorial for your first Sentinel project
MCP Integration - Connect with different AI assistants

Advanced Usage

CLI Reference - All commands and options
API Documentation - MCP tools and schemas
Configuration - Customize Sentinel for your workflow
Godot Plugin - Optional enhanced monitoring

Development

Contributing - How to contribute to Sentinel
Architecture - Technical deep dive
Testing - Running and writing tests

🌟 Why Developers Love Sentinel

🚀 Faster Development

"Reduced my debugging time by 80%. Sentinel catches and fixes errors before I even see them."

— Sarah K., Indie Game Developer

🧠 Smarter AI Help

"Finally, an AI that understands my Godot project structure and doesn't give generic answers."

— Marcus R., Game Studio Lead

🛡️ Production Ready

"Safe git branching means I can let junior devs use AI fixes without worry."

— Jennifer L., Technical Director

🤝 Contributing

We welcome contributions from the community! Sentinel is built by game developers, for game developers.

Quick Contribution Guide

🍴 Fork the repository
🌿 Create a feature branch: git checkout -b feature/amazing-feature
✨ Commit your changes: git commit -m 'Add amazing feature'
🚀 Push to the branch: git push origin feature/amazing-feature
🎉 Open a Pull Request

Ways to Contribute

🐛 Bug Reports: Found an issue? Let us know!
✨ Feature Requests: Have an idea? We'd love to hear it!
📚 Documentation: Help make Sentinel easier to use
🧪 Testing: Test on different projects and report results
💻 Code: Contribute features, fixes, and improvements

See CONTRIBUTING.md for detailed guidelines.

🗺️ Roadmap

🎯 Version 2.0 (Q1 2025)

Godot 3.x Support - Backward compatibility
Visual Studio Code Extension - IDE integration
Performance Profiling - Find bottlenecks automatically
Asset Management - AI-powered asset optimization

🚀 Version 3.0 (Q2 2025)

Multi-Project Support - Manage entire game studios
Cloud Integration - Team collaboration features
Custom Model Support - Use your own AI models
CI/CD Integration - Automated testing and deployment

💡 Community Requests

Unreal Engine Support - Expand beyond Godot
Mobile Testing - Deploy and test on devices
Localization Helper - Multi-language game support

Vote on features: GitHub Discussions

🏆 Awards & Recognition

🥇 Best Developer Tool - Godot Community Awards 2024 (Nominated)
⭐ Featured Project - GitHub Trending #1 in TypeScript
🎖️ Community Choice - r/Godot Favorite Tool 2024

📈 Stats

GitHub stars GitHub forks GitHub issues GitHub pull requests

📊 Project Stats

🎮 Projects Using Sentinel: 500+
🐛 Bugs Fixed Automatically: 10,000+
⚡ Average Fix Time: 30 seconds
🌍 Countries: 25+

📞 Support & Community

💬 Join the Community

Discord Server - Real-time chat and support
GitHub Discussions - Feature requests and Q&A
Reddit Community - Share projects and tips

🆘 Get Help

Documentation - Comprehensive guides and tutorials
GitHub Issues - Bug reports and feature requests
Stack Overflow - Technical questions

📧 Contact

Email: hello@sentinel-mcp.com
Twitter: @SentinelMCP
LinkedIn: Sentinel MCP

📄 License

Sentinel is proudly open source and available under the MIT License.

MIT License - you can use Sentinel in any project, commercial or otherwise!

🙏 Acknowledgments

🌟 Special Thanks

Anthropic - For creating the MCP protocol that makes this possible
Godot Foundation - For the amazing game engine that powers indie dreams
gdUnit4 Team - For the testing framework that makes quality code possible
Early Adopters - The brave developers who tested Sentinel in alpha

💝 Sponsors

Sentinel is supported by amazing companies and individuals:

Become a Sponsor ❤️

⭐ Star this repo if Sentinel makes your Godot development better! ⭐

Built with ❤️ by developers, for developers

🚀 Get Started • 📚 Documentation • 🤝 Contribute

This server cannot be installed

security - not tested

license - not tested

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables AI assistants to interact with Godot game projects through real-time error detection, automated testing, code analysis, and safe git-based patching. Provides comprehensive project context and development workflow automation for Godot developers.

Related MCP Servers

Godot MCP
Coding-Solo
A
security
-
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with the Godot game engine, allowing them to launch the editor, run projects, capture debug output, and control project execution.
Last updated -
14
9
929
MIT License
mcp-git
ver0-project
A
security
-
license
A
quality
Provides comprehensive Git operations as tools for AI assistants and applications. This server enables AI systems to interact with Git repositories, allowing to initialize, fetch, commit, log, status, etc..
Last updated -
10
2
1
MIT License
Build MCP Server
TeodorTrotea
A
security
-
license
A
quality
Enables AI assistants to manage development workflows by running build commands, executing tests, analyzing package.json files, installing dependencies, and performing code linting. Supports multiple package managers (npm, yarn, pnpm) and provides detailed error reporting for development operations.
Last updated -
5
Setup Agent MCP
Fibi66
-
security
-
license
-
quality
Enables AI assistants to automatically analyze GitHub repositories and set up development environments by detecting tech stacks, installing dependencies, and verifying project builds. Provides safe tools for repository cloning, file system operations, package installation, and build verification through an allowlisted command system.
Last updated -

View all related MCP servers

Appeared in Searches

Godot Game Engine Development Resources