How yurineko73/godot-mcp-native works
Godot MCP Native lets AI assistants inspect and edit a Godot project through MCP; its gdmcp CLI offers agent-friendly commands against the same service. The main workflow is assistant or CLI request → transport/API handling → tool execution → project operation and response. The graph also preserves the documented scene, node, script, resource, editor, debugging, project, and runtime capabilities. CLI wiring is supported by excerpts and the SOURCE INDEX; several Godot-side internals were not sampled, so their links rely on README statements or are omitted.
Main entry points: main.rs CLI entry · tool_executor.gd Tool registry and execution · client.rs API client · tool_call.rs Direct tool calls
Components 29
gdmcp CLI
- CLI entry
cli/gdmcp/src/main.rs - CLI config
cli/gdmcp/src/config.rs - Command routing
cli/gdmcp/src/cli.rs - API client
cli/gdmcp/src/client.rs - API contracts
cli/gdmcp/src/contracts.rs - Output rendering
cli/gdmcp/src/output.rs - Batch operations
cli/gdmcp/src/commands/batch.rs - Debug commands
cli/gdmcp/src/commands/debug.rs - Node commands
cli/gdmcp/src/commands/nodes.rs - Project commands
cli/gdmcp/src/commands/project.rs - Resource commands
cli/gdmcp/src/commands/resources.rs - Runtime commands
cli/gdmcp/src/commands/runtime.rs - Scene commands
cli/gdmcp/src/commands/scenes.rs - Script commands
cli/gdmcp/src/commands/scripts.rs - Direct tool calls
cli/gdmcp/src/commands/tool_call.rs - Tool discovery
cli/gdmcp/src/commands/tools.rs
MCP service
- MCP server
addons/godot_mcp/mcp_server_native.gd - HTTP / stdio
addons/godot_mcp/native_mcp/mcp_http_server.gd - Tool registry and execution
addons/godot_mcp/native_mcp/tool_executor.gd
Godot tools
- Node tools
addons/godot_mcp/tools/node_tools_native.gd - Scene tools
addons/godot_mcp/tools/scene_tools_native.gd - Script tools
addons/godot_mcp/tools/script_tools_native.gd - Resource tools
addons/godot_mcp/tools/resource_tools_native.gd - Editor tools
addons/godot_mcp/tools/editor_tools_native.gd - Project tools
addons/godot_mcp/tools/project_tools_native.gd - Debug tools
addons/godot_mcp/tools/debug_tools_native.gd
Project operations
- Runtime probe
addons/godot_mcp/runtime/mcp_runtime_probe.gd - Godot project
Other components
- AI assistant
Connections 39
- AI assistant → MCP server: sends MCP requests
README.md - AI assistant → CLI entry: runs commands
README.md - CLI entry → CLI config: loads config
cli/gdmcp/src/main.rs - CLI entry → Command routing: dispatches
cli/gdmcp/src/main.rs - CLI entry → API client: creates client
cli/gdmcp/src/main.rs - CLI entry → Output rendering: renders response
cli/gdmcp/src/main.rs - CLI entry → Batch operations: routes batch
cli/gdmcp/src/main.rs - CLI entry → Debug commands: routes debug
cli/gdmcp/src/main.rs - CLI entry → Node commands: routes nodes
cli/gdmcp/src/main.rs - CLI entry → Project commands: routes project
cli/gdmcp/src/main.rs - CLI entry → Resource commands: routes resources
cli/gdmcp/src/main.rs - CLI entry → Runtime commands: routes runtime
cli/gdmcp/src/main.rs - CLI entry → Scene commands: routes scenes
cli/gdmcp/src/main.rs - CLI entry → Script commands: routes scripts
cli/gdmcp/src/main.rs - CLI entry → Direct tool calls: routes direct call
cli/gdmcp/src/main.rs - CLI entry → Tool discovery: routes discovery
cli/gdmcp/src/main.rs - Scene commands → Direct tool calls: calls tool API
cli/gdmcp/src/commands/scenes.rs - Script commands → Direct tool calls: calls tool API
cli/gdmcp/src/commands/scripts.rs - Batch operations → API client: preflights and executes
cli/gdmcp/src/commands/batch.rs - Direct tool calls → API client: posts execution
cli/gdmcp/src/commands/tool_call.rs - API client → API contracts: decodes errors
cli/gdmcp/src/client.rs - API client → MCP server: sends HTTP requests
README.md - MCP server → HTTP / stdio: serves MCP
README.md - HTTP / stdio → Tool registry and execution: dispatches tools
- Tool registry and execution → Node tools: provides tools
README.md - Tool registry and execution → Scene tools: provides tools
README.md - Tool registry and execution → Script tools: provides tools
README.md - Tool registry and execution → Resource tools: provides tools
README.md - Tool registry and execution → Editor tools: provides tools
README.md - Tool registry and execution → Project tools: provides tools
README.md - Tool registry and execution → Debug tools: provides tools
README.md - Debug tools → Runtime probe: includes runtime probe
README.md - Node tools → Godot project: reads and edits
README.md - Scene tools → Godot project: reads and edits
README.md - Script tools → Godot project: reads and edits
README.md - Resource tools → Godot project: reads and edits
README.md - Editor tools → Godot project: controls editor
README.md - Project tools → Godot project: inspects project
README.md - Runtime probe → Godot project: observes runtime
README.md