# 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