godot-mcp

https://github.com/Arhend/godot-mcp

I wanted a simple MCP server for Godot 4 to help with development — mainly searching the class reference docs and reading project files without having to manually paste things into the chat.

What it does

Docs & API lookup — pulls from the Godot engine's XML class reference on GitHub and caches it locally:

• search_godot_class — look up any class (Node, CharacterBody2D, etc.) and get its methods, properties, and signals
• get_class_method — full details on a specific method
• get_class_property — full details on a specific property
• list_godot_classes — browse all ~570 classes, filter by name prefix or parent class
• search_godot_docs — free-text search across all class descriptions, method names, and more

Project file analysis — reads your local Godot project files directly:

• read_scene — parses a .tscn file into a node tree
• read_resource — parses a .tres resource file
• read_script — reads a .gd script
• get_project_info — reads project.godot for name, main scene, autoloads
• find_project_files — find files by extension in your project directory

Setup

git clone https://github.com/Arhend/godot-mcp
cd godot-mcp
npm install
npm run build

Add to Claude Code as an MCP server:

claude mcp add godot -- npx github:Arhend/godot-mcp

The first time you use a docs tool, it fetches and caches the Godot class reference from GitHub (~30 seconds). After that it loads from the local cache in cache/ and is instant. The cache refreshes automatically after 7 days.