React Native Godot MCP

Developer tools Education and learning tools .Python

rating : 2.5 points

downloads : 6.6K

update time : 2025-12-12

Open Site

Installation

Copy the following command to your Client for configuration

{
  "mcpServers": {
    "react-native-godot": {
      "command": "python",
      "args": ["/path/to/react_native_godot_mcp.py"],
      "env": {}
    }
  }
}

Note: Your key is sensitive information, do not share it with anyone.

🚀 React Native Godot Documentation MCP Server

A powerful Model Context Protocol (MCP) server that enables intelligent access to React Native Godot documentation, examples, and implementation guides. This server allows LLMs to efficiently retrieve and search documentation from the react-native-godot repository by Born.com and Migeran.

🚀 Quick Start

This MCP server offers a range of tools for accessing React Native Godot documentation. To get started, you need to install the necessary dependencies and make the server executable. After that, you can run the server and integrate it with different clients.

✨ Features

Agent-Centric Design

This MCP server adheres to best practices for agent-oriented tool design:

Workflow-focused tools: These tools are designed to complete entire tasks, not just wrap APIs.
Optimized for context efficiency: They feature configurable detail levels.
Actionable error messages: These messages guide agents towards solutions.
Natural task subdivisions: Tools have intuitive names for easy understanding.

Available Tools

📖 `get_documentation`

Retrieve specific sections of React Native Godot documentation, including:

Overview, installation, and initialization
API usage, threading, and views
Export, debugging, and custom builds
Configurable detail levels (concise/detailed/full)

🔍 `search_documentation`

Perform intelligent searches across all documentation:

Keyword-based search with relevance scoring
Returns the most relevant sections
Ideal for finding specific topics or troubleshooting

💻 `get_example_code`

Obtain working code examples for:

Initialization and setup
API usage patterns
Signal handling
View embedding
Worklets and threading
Complete application examples

🛠️ `get_setup_instructions`

Get platform-specific setup guidance:

iOS and Android configurations
Debugging setup options
Custom build instructions
Step-by-step installation process

📚 `get_api_reference`

Access detailed API documentation for:

RTNGodot class methods
RTNGodotView component
runOnGodotThread function
Signals and callables
Property access patterns

🔧 `get_troubleshooting`

Find solutions for common issues:

Build errors
View display problems
Threading issues
Export problems
Performance optimization

📁 `get_file_from_repo`

Directly access repository files:

Example implementations
Configuration files
Build scripts
Native code

📦 Installation

Prerequisites

# Python 3.8+
python --version

# Install MCP and FastMCP
pip install mcp fastmcp

Install Dependencies

pip install httpx pydantic

Make Executable

chmod +x react_native_godot_mcp.py

💻 Usage Examples

Running the Server

Standalone Mode

python react_native_godot_mcp.py

With MCP Inspector (for testing)

npx @modelcontextprotocol/inspector python react_native_godot_mcp.py

Integration with Claude Desktop

Add the following to your Claude configuration file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "react-native-godot": {
      "command": "python",
      "args": ["/path/to/react_native_godot_mcp.py"],
      "env": {}
    }
  }
}

Integration with Other MCP Clients

The server uses stdio transport and can be integrated with any MCP-compatible client:

# Example Python client usage
from mcp import Client

client = Client()
client.connect_stdio(["python", "react_native_godot_mcp.py"])

# Use tools
result = await client.call_tool(
    "get_documentation",
    {"section": "initialization", "detail": "detailed"}
)

Basic Usage

# Example of using get_setup_instructions
get_setup_instructions(platform="both", include_debugging=True)

# Example of using get_example_code
get_example_code(topic="initialization", platform="ios")

Advanced Usage

# Advanced search example
search_documentation(query="worklets threading", max_results=5)

# Get API reference with examples
get_api_reference(topic="RTNGodot", include_examples=True)

📚 Documentation

Example Queries

Get Started with React Native Godot

# Fetch installation instructions
get_setup_instructions(platform="both", include_debugging=True)

# Get initialization example
get_example_code(topic="initialization", platform="ios")

Search for Specific Topics

# Search for worklet information
search_documentation(query="worklets threading", max_results=5)

# Find signal handling docs
search_documentation(query="connect signals JavaScript")

Troubleshoot Issues

# Get help with build errors
get_troubleshooting(issue="build_error", platform="android")

# Debug view problems
get_troubleshooting(issue="view_not_showing")

Deep Dive into API

# Get RTNGodot API reference
get_api_reference(topic="RTNGodot", include_examples=True)

# Learn about signals
get_api_reference(topic="signals")

Running Evaluations

The repository includes comprehensive evaluation questions to test the MCP server's capabilities.

Using the Evaluation File

The evaluation file (react_native_godot_evaluation.xml) contains 10 complex questions.
Each question tests the server's ability to find specific information.
Questions cover initialization, threading, debugging, API usage, and more.

Running Evaluations with MCP

# Install evaluation tools
pip install mcp-eval

# Run evaluation
mcp-eval run react_native_godot_mcp.py react_native_godot_evaluation.xml

Manual Testing

You can manually test each tool:

# Test documentation fetching
python -c "
import asyncio
from react_native_godot_mcp import get_documentation

async def test():
    result = await get_documentation(None, 'threading', 'markdown', 'detailed')
    print(result)

asyncio.run(test())
"