Skip to main content
Glama

Godot Sentinel MCP

by Snack-JPG

🤖 Godot Sentinel MCP

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

Quick StartFeaturesDemoInstallDocs


"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

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:

ToolDescriptionExample 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

Advanced Usage

Development


🌟 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

  1. 🍴 Fork the repository
  2. 🌿 Create a feature branch: git checkout -b feature/amazing-feature
  3. ✨ Commit your changes: git commit -m 'Add amazing feature'
  4. 🚀 Push to the branch: git push origin feature/amazing-feature
  5. 🎉 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

🆘 Get Help

📧 Contact


📄 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

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

  1. 🚀 What is Sentinel?
    1. 🎯 The Problem We Solve
      1. ✨ Features
        1. 🧠 AI-Native Architecture
        2. 🔍 Intelligent Error Detection
        3. 🛡️ Safe & Professional
        4. ⚡ Terminal-First Workflow
      2. 🎬 Demo
        1. Basic Error Fixing
        2. Watch Mode (Live Development)
        3. Project Understanding
      3. 🚀 Quick Start
        1. 1. Install Sentinel
        2. 2. Setup Your Godot Project
        3. 3. Start the MCP Server
        4. 4. Connect Your AI Assistant
        5. 5. Start Coding!
      4. 🛠️ Installation
        1. Prerequisites
        2. Install Options
      5. 🎮 MCP Tools Reference
        1. 🏗️ Architecture
          1. Core Components
        2. 📚 Documentation
          1. Getting Started
          2. Advanced Usage
          3. Development
        3. 🌟 Why Developers Love Sentinel
          1. 🚀 Faster Development
          2. 🧠 Smarter AI Help
          3. 🛡️ Production Ready
        4. 🤝 Contributing
          1. Quick Contribution Guide
          2. Ways to Contribute
        5. 🗺️ Roadmap
          1. 🎯 Version 2.0 (Q1 2025)
          2. 🚀 Version 3.0 (Q2 2025)
          3. 💡 Community Requests
        6. 🏆 Awards & Recognition
          1. 📈 Stats
            1. 📞 Support & Community
              1. 💬 Join the Community
              2. 🆘 Get Help
              3. 📧 Contact
            2. 📄 License
              1. 🙏 Acknowledgments
                1. 🌟 Special Thanks
                2. 💝 Sponsors
              2. ⭐ Star this repo if Sentinel makes your Godot development better! ⭐

                Related MCP Servers

                • -
                  security
                  A
                  license
                  -
                  quality
                  A server that enables AI assistants to understand and interact with Unity projects in real-time, providing access to scene hierarchy, project settings, and the ability to execute code directly in the Unity Editor.
                  Last updated -
                  80
                  MIT License
                  • Linux
                  • Apple
                • A
                  security
                  A
                  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
                  13
                  720
                  JavaScript
                  MIT License
                  • Linux
                  • Apple
                • -
                  security
                  F
                  license
                  -
                  quality
                  Provides integration with Gerrit code review system, allowing AI assistants to fetch change details and compare patchset differences for code reviews.
                  Last updated -
                  19
                  Python
                  • Apple
                  • Linux
                • A
                  security
                  A
                  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
                  TypeScript
                  MIT License

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/Snack-JPG/Godot-Sentinel-MCP'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server