# Godot MCP Server
An MCP (Model Context Protocol) server that provides tools for Godot Engine development.
## Features
- **godot_run_tests** - Run GUT (Godot Unit Test) tests and get structured results
- **godot_check_errors** - Check for parse/syntax errors without running the game
- **godot_import** - Import/reimport assets
- **godot_run_scene** - Run a specific scene
- **godot_export** - Export project to a platform
## Installation
```bash
cd mcp/godot-mcp
uv pip install -e .
```
Or with pip:
```bash
pip install -e mcp/godot-mcp
```
## Configuration
Add to your Claude Code MCP configuration (`~/.claude/mcp.json`):
```json
{
"mcpServers": {
"godot": {
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp/godot-mcp", "godot-mcp"],
"env": {
"QT_QPA_PLATFORM": "xcb",
"__GLX_VENDOR_LIBRARY_NAME": "mesa"
}
}
}
}
```
Or if installed globally:
```json
{
"mcpServers": {
"godot": {
"command": "godot-mcp"
}
}
}
```
## Usage
Once configured, Claude Code can use these tools:
### Run Tests
```
Use godot_run_tests to run the unit tests
```
### Check for Errors
```
Use godot_check_errors to check for parse errors
```
### Run a Scene
```
Use godot_run_scene to run the game
```
## Requirements
- Python 3.10+
- Godot 4.x installed and in PATH
- GUT (Godot Unit Test) addon for test functionality
## License
MIT
