Godot MCP Documentation Server

中文文档 | English

A Model Context Protocol (MCP) server that provides AI assistants with access to the complete Godot Engine documentation, helping developers with Godot development by serving documentation directly to LLMs.

Purpose

This server bridges the gap between AI assistants and Godot documentation, allowing developers to get instant, accurate answers about Godot classes, tutorials, and features without leaving their AI chat interface.

Project Origin

This project is based on godot-mcp-docs by Nihilantropy, modified for local development on Windows without Docker.

Installation

1. Install uv (if not already installed):

   # On Windows with PowerShell: Invoke-WebRequest -Uri https://astral.sh/uv/install.ps1 -UseBasicParsing | Invoke-Expression

2. Clone the repository:

   git clone https://github.com/Nihilantropy/godot-mcp-docs.git cd godot-mcp-docs

3. Install Python dependencies:

   uv sync

   This command reads from pyproject.toml and creates a virtual environment.

   Note: uv sync uses pyproject.toml as the source of truth, not requirements.txt. This is the modern Python packaging standard (PEP 517/518/621). The uv.lock file ensures consistent dependency versions across environments.

Setting Up Documentation

After installing dependencies, you need to download and process the Godot documentation:

1. Generate documentation:

   uv run python .\docs_converter\godot_docs_converter.py

2. Move docs folder to root: After conversion, move the generated docs folder to the project root directory.

3. Generate documentation tree:

   cd docs tree /f > docs_tree.txt cd ..

   Note: If you encounter Chinese encoding issues, use:

   tree /f | Out-File -Encoding utf8 docs_tree.txt

Running the Server

Start the MCP server locally:

Configuring MCP Client

Claude Desktop Example

Add this to your Claude Desktop configuration file:

Available Tools

• get_documentation_tree() - Get a tree-style overview of the entire documentation structure

• get_documentation_file(file_path: str) - Retrieve the content of specific documentation files

Sample Usage

Explore documentation structure:

Get specific class documentation:

Learn about tutorials:

Get specific tutorial content:

Compare classes:

Debugging

Option 1: FastMCP Dev UI (Recommended)

Start the server in dev mode:

Then open your browser to http://127.0.0.1:8000 to see all tools and test them interactively.

Option 2: MCP Inspector (Official Debugger)

Use Anthropic's official MCP Inspector:

This opens http://localhost:5173 in your browser, showing all tools, request/response logs, and allowing manual tool testing. No need to run uv run python main.py separately.

Option 3: HTTP API Debugging

Send JSON-RPC requests to the server:

Or using curl:

Understanding Path Resolution

The DOCS_DIR = Path("docs").resolve() in the code is relative to the current working directory (CWD) when you run Python, not the script location.

Example

Assume your directory structure:

Case A: Running from root directory

• Current Working Directory: D:\Codes\16_MCP

• Path("docs") resolves to: D:\Codes\16_MCP\docs (Success)

Case B: Running from subdirectory (common error)

• Current Working Directory: D:\Codes\16_MCP\srcs

• Path("docs") resolves to: D:\Codes\16_MCP\srcs\docs (Fails - no docs folder)

Best Practice

To ensure paths work regardless of where you run from, use __file__-based absolute positioning:

PowerShell Output Redirection Tips

Save output to file:

• Overwrite (clears existing content):

  ls > list.txt

• Append (preserves existing content):

  ls >> list.txt

• With UTF8 encoding (recommended for Chinese):

  ls | Out-File -FilePath output.txt -Encoding utf8

• See on screen and save:

  ls | Tee-Object -FilePath log.txt

Documentation Structure

The server provides access to the complete official Godot documentation with this structure:

Recommended System Prompt

For optimal results when working with Godot, use this system prompt:

"When working with Godot game development questions, always search for the latest available documentation using the godot-mcp-docs tools. Start with get_documentation_tree() to understand the documentation structure, then use get_documentation_file() to retrieve specific information about classes, tutorials, or features. Prioritize official Godot documentation over general knowledge when providing Godot-related assistance."

Updating Documentation

To update to a newer version of Godot documentation:

License

This project is licensed under the MIT License - see the LICENSE file for details.

The Godot documentation content follows the original Godot documentation licensing:

• Documentation content (excluding classes/ folder): CC BY 3.0

• Class reference files (classes/ folder): MIT License

• Attribution: "Juan Linietsky, Ariel Manzur and the Godot community"