{"report":{"v":1,"package":"@shin2344234/godot-mcp","version":"0.1.2","ranAt":"2026-11-16T11:50:19.160Z","install":{"ok":true,"integrity":"sha512-/CXZiNVZIKN6F8P+ODMU4LP2/x9m/rZaaBNjBKTnA8sgA6XuRbRuKTdz3v+35/s7LUvtjYlnZ8w8iH3HUcXYpw==","deps":13,"scripts":[],"bins":["godot-mcp"],"license":"MIT","engines":"node >=22","repository":"git+https://github.com/shin2344234/godot-mcp.git","bin":"godot-mcp"},"start":{"ok":true,"ms":195,"serverName":"godot-mcp","serverVersion":"0.1.2","protocol":"2025-06-18","stderr":"[godot-mcp] 2026-11-16T11:50:22.066Z INFO godot-mcp 0.1.2 for project / (mode full)\n[godot-mcp] 2026-11-16T11:50:25.127Z ERROR Operation failed Error: No project.godot found at /project.godot. Start the server from your Godot project folder, or pass --project <path> (or set GODOT_PROJECT_PATH).\n    at readProjectSettings (file:///app/node_modules/@shin2344234/godot-mcp/dist/project/projectFile.js:162:15)\n    at async Object.run (file:///app/node_modules/@shin2344234/godot-mcp/dist/ops/core.js:173:26)\n    at async execute (file:///app/node_modules/@shin2344234/godot-mcp/dist/mcp/server.js:90:29)\n    at async file:///app/node_modules/@modelcontextprotocol/server/dist/mcp-oHn3ureC.mjs:1609:20\n    at async Server._invokeInputRequiredCapableHandler (file:///app/node_modules/@modelcontextprotocol/server/dist/mcp-oHn3ureC.mjs:1040:13)\n    at async file:///app/node_modules/@modelcontextprotocol/server/dist/mcp-oHn3ureC.mjs:991:19\n"},"tools":[{"name":"godot_status","description":"Godot status: call this first. Shows the project, whether the live editor is connected (open scenes, unsaved changes, playing state), the Godot executable found, and running games.","params":[]},{"name":"godot_addon_install","description":"Godot addon: install or update addons/godot_mcp (the editor bridge and game runtime this server needs) from the copy bundled with the server, and enable it in project.godot.","params":[]},{"name":"godot_project_info","description":"Godot project facts from project.godot: name, Godot version, main scene, autoloads, input action names, renderer, enabled plugins, C# and test framework detection.","params":[]},{"name":"godot_project_settings","description":"Godot project settings: read raw values from project.godot, filtered by key prefix (e.g. \"display/window\", \"input/jump\"). Only non-default values are stored in the file.","params":["prefix","limit"]},{"name":"godot_files_list","description":"Godot files: list a project folder (res://...). Skips .godot/ and .git/; hides .uid/.import sidecars and, when recursive, addons/ contents unless all. Use recursive with a glob-like \"pattern\" (e.g. \"*.tscn\") to find files by type.","params":["path","recursive","pattern","all","max"]},{"name":"godot_files_read","description":"Godot files: read a text file (script, scene .tscn, resource .tres, shader, config) with line numbers. Use offset/limit for long files.","params":["path","offset","limit"]},{"name":"godot_files_search","description":"Godot files: search text across project files (scripts, scenes, resources, shaders). Literal by default; set regex for a regular expression.","params":["query","regex","case_sensitive","path","pattern","max_results"]},{"name":"godot_files_write","description":"Godot files: create or overwrite a text file (e.g. a .gd script or .gdshader). GDScript files are then checked for parse and type errors (as godot_script_validate). Prefer godot_files_edit for small changes to existing files.","params":["path","content","overwrite"]},{"name":"godot_files_edit","description":"Godot files: replace an exact snippet in a text file (old_text -> new_text). old_text must match exactly once unless replace_all. GDScript files are then checked for parse and type errors (as godot_script_validate).","params":["path","old_text","new_text","replace_all"]},{"name":"godot_files_move","description":"Godot files: move or rename a file or folder, carrying its .uid/.import sidecar files. References by uid:// keep working; plain res:// references in other files are NOT updated.","params":["from","to"]},{"name":"godot_files_delete","description":"Godot files: delete a file (and its .uid/.import sidecars). Deleting a folder requires recursive: true. This cannot be undone.","params":["path","recursive"]},{"name":"godot_scene_tree","description":"Godot scene: show the node tree (names, types, scripts, instanced sub-scenes) of a scene. Use depth/max_nodes to keep large scenes small; start from a subtree with root.","params":["scene","root","depth","max_nodes"]},{"name":"godot_scene_create","description":"Godot scene: create a new .tscn file with a root node of the given type (e.g. Node2D, Node3D, Control, CharacterBody2D).","params":["path","root_type","root_name","open"]},{"name":"godot_scene_open","description":"Godot scene: open a scene in the editor so later node operations target it.","params":["path"]},{"name":"godot_scene_save","description":"Godot scene: save the edited scene in the editor (headless edits are saved automatically).","params":["path"]},{"name":"godot_scene_save_as","description":"Godot scene: save the edited scene under a new path (editor only).","params":["path"]},{"name":"godot_node_get","description":"Godot node: read a node's type, script, non-default property values and connected signals. Pass properties to read only some.","params":["scene","path","properties"]},{"name":"godot_node_add","description":"Godot node: add a node of a built-in type (e.g. Sprite2D, CollisionShape2D, Label) or an instance of a .tscn scene, with optional initial properties. Undoable in the editor.","params":["scene","parent","type","instance","name","properties","index"]},{"name":"godot_node_set","description":"Godot node: set one or more properties on a node (position, texture, shape, modulate, ...). Returns the values read back. Undoable in the editor.","params":["scene","path","properties"]},{"name":"godot_node_remove","description":"Godot node: delete a node and its children from the scene. Undoable in the editor; permanent when headless.","params":["scene","path"]},{"name":"godot_node_rename","description":"Godot node: rename a node. Note: scripts or NodePaths that refer to the old name are not updated.","params":["scene","path","name"]},{"name":"godot_node_reparent","description":"Godot node: move a node under a different parent (and/or to a child index), keeping its global transform by default.","params":["scene","path","new_parent","index","keep_global_transform"]},{"name":"godot_node_duplicate","description":"Godot node: duplicate a node (with children, script and properties) next to the original.","params":["scene","path","name"]},{"name":"godot_script_attach","description":"Godot script: attach a .gd (or .cs) script to a node, or detach with script: null. Create the file first with godot_files_write.","params":["scene","path","script"]},{"name":"godot_script_validate","description":"Godot script: check GDScript for parse/type errors without running the game. Pass a file path, or source text to check before writing.","params":["path","source"]},{"name":"godot_run_start","description":"Godot run: start the game (main scene, the current scene, or a given scene). Returns a run_id; read errors and prints with godot_run_output, stop with godot_run_stop.","params":["scene","mode","headless","quit_after_frames","breakpoints","break_on_errors","write_movie"]},{"name":"godot_run_stop","description":"Godot run: stop a running game (the given run_id, the latest process run, or the game playing in the editor).","params":["run_id"]},{"name":"godot_run_output","description":"Godot run: read output and errors of a game started with godot_run_start (process or editor mode). Use level \"error\" to see only errors, and \"since\" (the \"next\" value from the last call) to page.","params":["run_id","since","limit","level","errors"]},{"name":"godot_editor_logs","description":"Godot editor: read messages, warnings and errors printed by the editor process (plugin and tool scripts, import errors; not a running game's prints). Repeats are merged with a count. Page with \"since\".","params":["since","limit","level"]},{"name":"godot_editor_launch","description":"Godot editor: open this project in the Godot editor and wait until the MCP plugin connects (the plugin must be enabled in the project).","params":["wait_seconds","headless"]},{"name":"godot_node_instance","description":"Godot node: instance a .tscn as a linked sub-scene under a parent, optionally with Editable Children. Undoable in the editor.","params":["scene","instance","parent","name","properties","index","editable_children"]},{"name":"godot_node_find","description":"Godot node: find nodes in a scene by name (glob/substring), type (incl. subclasses), group, script or property value.","params":["scene","name","type","group","script","property","value","root","limit"]},{"name":"godot_node_move","description":"Godot node: move a node to another position among its siblings (draw/process order). Undoable in the editor.","params":["scene","path","index"]},{"name":"godot_node_groups","description":"Godot node: add or remove a node's groups (saved in the scene). Undoable in the editor.","params":["scene","path","add","remove"]},{"name":"godot_scene_inherit","description":"Godot scene: create a new scene file that inherits a base scene (like \"New Inherited Scene\"); opens it in the editor.","params":["path","base","root_name","open"]},{"name":"godot_scene_close","description":"Godot scene: close a scene tab in the editor. Refuses unsaved changes unless save or discard is true.","params":["path","save","discard"]},{"name":"godot_batch_apply","description":"Godot scene: apply up to 100 scene edits (node.add, node.set, signal.connect, ...) to one scene in order, all-or-nothing; one undo step in the editor.","params":["scene","ops"]},{"name":"godot_signal_list","description":"Godot signal: list saved signal connections of a node or scene and flag problems (missing/mismatched handlers, unconnected _on_* methods).","params":["scene","path","recursive","include_available"]},{"name":"godot_signal_connect","description":"Godot signal: connect a node's signal to a method (saved in the scene), optionally creating the handler stub in the target's script.","params":["scene","from","signal","to","method","create_method","binds","unbinds","flags"]},{"name":"godot_signal_disconnect","description":"Godot signal: remove a saved signal connection from a scene. Undoable in the editor.","params":["scene","from","signal","to","method"]},{"name":"godot_resource_read","description":"Godot resource: read a .tres/.res/.gdshader (or uid://): class, uid, non-default properties, shader uniforms, theme items.","params":["path","properties","depth"]},{"name":"godot_resource_create","description":"Godot resource: create a resource file of any Resource class (materials, Theme, Gradient, shapes...) or a .gdshader with code.","params":["path","type","properties","code","overwrite"]},{"name":"godot_resource_set","description":"Godot resource: set properties of an existing resource file and save it (undoable in the editor; open scenes update).","params":["path","properties"]},{"name":"godot_resource_deps","description":"Godot resource: list a file's dependencies (missing ones flagged), optionally the files that use it; resolves uid:// paths.","params":["path","dependents","limit"]},{"name":"godot_visual_shader_graph","description":"Godot visual: edit or create a VisualShader .tres with ordered node ops (add, connect, set...).","params":["path","create","mode","shader_type","ops"]},{"name":"godot_visual_shader_graph_read","description":"Godot visual: list a VisualShader's nodes (id, class, properties) and connections per shader type.","params":["path","shader_type"]},{"name":"godot_visual_layout","description":"Godot visual: apply a Control layout preset, anchors/offsets, size flags or minimum size. Undoable.","params":["scene","path","preset","resize_mode","margin","anchors","offsets","size_flags","custom_minimum_size"]},{"name":"godot_visual_shader_check","description":"Godot visual: compile shader code or a .gdshader/VisualShader file and report errors with line numbers.","params":["path","code"]},{"name":"godot_anim_read","description":"Godot animation: list an AnimationPlayer's libraries and animations, or with animation the tracks and keys of one. Pass library (a .tres) instead of a scene player to read an AnimationLibrary file.","params":["scene","player","library","animation","max_keys"]},{"name":"godot_anim_edit","description":"Godot animation: create/remove/rename animations and add tracks and keys on an AnimationPlayer. ops run in order as one undo step; track paths are \"Node:property\" relative to the player's root_node.","params":["scene","player","animation","allow_missing","ops"]},{"name":"godot_anim_tree_read","description":"Godot animation: show an AnimationTree's graph (states, transitions, blend points, blend tree nodes) and its parameters.","params":["scene","tree","parameters"]},{"name":"godot_anim_tree","description":"Godot animation: build an AnimationTree state machine, blend space or blend tree (states, transitions, start/end, blend points). ops run in order as one undo step.","params":["scene","tree","nested","allow_missing","ops"]},{"name":"godot_anim_frames","description":"Godot animation: read or edit the SpriteFrames of an AnimatedSprite2D/3D (or a .tres): add/rename/remove animations, speed/loop, frames cut from a sprite sheet. No ops = summary.","params":["scene","node","path","ops"]},{"name":"godot_grid_read","description":"Godot world: read a TileMapLayer/GridMap: cells, bounds and the TileSet tiles/terrains or MeshLibrary items to paint with.","params":["scene","path","region","limit","summary_only"]},{"name":"godot_grid_edit","description":"Godot world: paint a TileMapLayer/GridMap with ordered ops (set, erase, fill_rect, terrain; clear wipes all cells). One undo step.","params":["scene","path","ops"]},{"name":"godot_tileset_edit","description":"Godot world: create/edit a TileSet .tres: atlas sources, collision (one-way), navigation, occlusion, terrains, custom data, per-tile values, alternative tiles, animation. Saved at once.","params":["path","create","tile_size","ops"]},{"name":"godot_navigation_bake","description":"Godot world: bake a NavigationRegion2D/3D from its child colliders, meshes, GridMaps and TileMapLayers.","params":["scene","path","outline","agent_radius"]},{"name":"godot_navigation_path","description":"Godot world: shortest path between two points over the scene's baked navigation regions.","params":["scene","from","to","path","optimize","layers"]},{"name":"godot_audio_buses","description":"Godot audio: list the audio buses (volume, mute, solo, send) and their effects from the project's bus layout.","params":[]},{"name":"godot_audio_edit","description":"Godot audio: add, remove, rename, move and set buses (volume, mute, solo, send) and their effects; saves the bus layout.","params":["ops"]},{"name":"godot_project_set","description":"Godot project: change project settings (project.godot); null resets one to its default. Values are converted to each setting's type.","params":["settings","create"]},{"name":"godot_input_edit","description":"Godot project: edit the input map (actions and their key/mouse/gamepad bindings), applied in order and saved to project.godot.","params":["ops"]},{"name":"godot_autoload_edit","description":"Godot project: add, remove or reorder autoloads (global singletons loaded at startup).","params":["op","name","path","singleton","index"]},{"name":"godot_project_plugins","description":"Godot project: enable or disable editor plugins (addons) and list the available ones.","params":["enable","disable","force"]},{"name":"godot_project_validate","description":"Godot project: health check for missing dependencies, stale or duplicate UIDs, script compile errors, broken autoloads, main scene and plugins.","params":["scope","path_prefix","deep","addons","limit","offset"]},{"name":"godot_import_get","description":"Godot import: show an asset's importer, non-default options (full: all), uid and whether its imported files exist (imports new assets first).","params":["path","full"]},{"name":"godot_import_set","description":"Godot import: change an asset's import options (or importer) and reimport it.","params":["path","options","importer"]},{"name":"godot_export_presets","description":"Godot export: list export presets (platform, path, filters, options; secrets redacted) and whether export templates are installed.","params":["preset"]},{"name":"godot_export_preset_set","description":"Godot export: change an export preset's fields/options, or create a preset, in export_presets.cfg.","params":["preset","set","create","allow_new_keys","allow_secrets"]},{"name":"godot_export_run","description":"Godot export: build the game with an export preset (release, debug, pack-only .pck/.zip, or patch); long-running.","params":["preset","mode","output","patches","allow_outside_project","timeout_s"]},{"name":"godot_code_diagnostics","description":"Godot code: GDScript errors and warnings for .gd files or a folder, from the language server.","params":["paths"]},{"name":"godot_code_symbols","description":"Godot code: outline of a .gd file (funcs, signals, vars, consts, classes with lines), or find symbols by name with query.","params":["path","query"]},{"name":"godot_code_lookup","description":"Godot code: hover docs, definition, references, signature, completion or highlights at a position in a .gd file.","params":["path","line","column","symbol","kind","limit"]},{"name":"godot_code_rename","description":"Godot code: rename a GDScript symbol across the project via the language server (skips comments/strings). dry_run previews.","params":["path","line","column","symbol","new_name","dry_run","include_comments"]},{"name":"godot_docs_search","description":"Godot docs: search the offline class reference (engine + project classes) by class/member name or words.","params":["query","kind","limit"]},{"name":"godot_docs_class","description":"Godot docs: class reference for an engine or project class, or one member (\"Class.member\"), as markdown.","params":["name","members","inherited","max_chars"]},{"name":"godot_game_tree","description":"Godot game: the running game's live nodes as a flat list (path, class, script, rect/pos, visible text). Filters list matches only; text \"Start\" finds the button to click.","params":["run_id","root","depth","max_nodes","name","class","group","text"]},{"name":"godot_game_get","description":"Godot game: current values of a live node: script variables and non-default properties (or listed ones, \"prop:sub\" ok), groups; optionally signal connections and script methods.","params":["run_id","path","properties","signals","methods"]},{"name":"godot_game_edit","description":"Godot game: change the running game with ops in order: set properties, call a method (returns its value, awaits coroutines), spawn, remove, change/reload scene. Stops at the first failing op; earlier ops stay (no undo, nothing saved).","params":["run_id","ops"]},{"name":"godot_game_eval","description":"Godot game: evaluate code in the running game: an Expression with self = node (default; autoloads and singletons by name), or a GDScript body of func run(node, tree, inputs) (use return). Off unless the server runs with --allow-eval.","params":["run_id","code","mode","path","inputs"]},{"name":"godot_game_input","description":"Godot game: send input steps in order (keys, actions, clicks on positions or nodes, drags, scroll, typing, joypad, touch, waits). Reports the Control and physics object under each click.","params":["steps","run_id"]},{"name":"godot_game_time","description":"Godot game: pause/resume the whole game (Godot's suspend: no node processes; SceneTree.paused untouched), step frames or physics ticks, set speed, or wait for a node, signal, condition, frames or seconds.","params":["action","frames","physics_ticks","scale","node","signal","condition","seconds","timeout_ms","run_id"]},{"name":"godot_game_record","description":"Godot game: record the game's input events (real and injected) with timestamps, stop to get them as compact JSON (or save to a file), and replay them with the original timing.","params":["action","path","recording","speed","run_id"]},{"name":"godot_game_screenshot","description":"Godot game: screenshot the running game (window, a node's viewport, or a region) or the editor's 2D/3D view, scaled down. Can save it and diff against a saved image.","params":["run_id","source","node","region","max_size","format","quality","save_to","compare_to","tolerance"]},{"name":"godot_game_perf","description":"Godot game: performance monitors of the running game (fps, frame times, memory, objects, draw calls...); optionally sample frames (stats, spikes) and profile script functions.","params":["run_id","sample_seconds","profile_scripts_seconds","top","monitors"]},{"name":"godot_debug_state","description":"Godot debug: is the game stopped (breakpoint, error, pause)? Call stack and variables (locals, members, globals) of a frame.","params":["frame","variables","globals","expand","wait","run_id"]},{"name":"godot_debug_control","description":"Godot debug: continue, pause, step_into/over/out (returns the new location and locals), or evaluate an expression in a stopped game (process runs).","params":["action","expression","frame","wait","run_id"]},{"name":"godot_debug_breakpoints","description":"Godot debug: list, add, remove or clear breakpoints of a game started with godot_run_start (process mode), running or stopped.","params":["action","breakpoints","run_id"]},{"name":"godot_test_run","description":"Godot test: run GUT or GdUnit4 tests headlessly (all, a folder, a file or one test name); returns totals and failures with file:line.","params":["path","test","framework","timeout_s"]},{"name":"godot_editor_ui","description":"Godot editor: get/set the selected nodes, open a script at a line, save all scenes and scripts, or show a toast.","params":["action","paths","scene","script","line","column","message","severity"]},{"name":"godot_tools","description":"Godot tool catalog: search all available Godot operations by keyword (\"search\"), or get full parameter schemas for some (\"describe\").","params":["action","query","operations"]}],"toolsHash":"a79a9f94ce3a4b77f159e140b93b4a0cc8c608e0defeefd50bea677e086d837c","wrote":[],"callsAt":"2026-11-16T11:50:24.115Z","calls":[{"tool":"godot_status","ok":true,"ms":9,"bytes":234},{"tool":"godot_project_info","ok":false,"ms":2,"bytes":0,"error":"tool reported an error: INTERNAL: No project.godot found at /project.godot. Start the server from your Godot project folder, or pass --project <path> (or set GODOT_PROJECT_PATH)."},{"tool":"godot_files_list","ok":true,"ms":3,"bytes":504},{"tool":"godot_node_find","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: BAD_PARAMS: The editor is not connected, so pass \"scene\" (a res:// path to a .tscn) to say which scene file to work on."},{"tool":"godot_anim_read","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: BAD_PARAMS: The editor is not connected, so pass \"scene\" (a res:// path to a .tscn) to say which scene file to work on."}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[{"kind":"orders","tool":"godot_status","quote":"Godot status: call this first. Shows the project, whether the live editor is connected (open scenes, unsaved changes, playing sta"}],"tools":91,"wrote":0,"callsTried":5,"callsAnswered":2,"callContacts":[]},"history":[{"package":"@shin2344234/godot-mcp","version":"0.1.2","ranAt":"2026-11-16T11:50:19.160Z","outcome":"started","tools":91,"contacts":0,"flags":1,"serious":0,"toolsHash":"a79a9f94ce3a4b77f159e140b93b4a0cc8c608e0defeefd50bea677e086d837c"}],"page":"https://bragproof.smaverk.com/r/%40shin2344234/godot-mcp"}