Setup ng Godot MCP

Unawain kung anong koneksyon ang ibinibigay ng MCP

Dinudokumento ng Coding-Solo/godot-mcp ang mga tool para magpatakbo ng Godot project, kumuha ng debug output, at mag-operate sa scene. Project-maintained bridge ito, hindi model service o opisyal na Godot distribution. Kailangan pa rin ng agent ng sarili nitong model access at angkop na lokal na permission.

Panatilihin sa setup record ang tatlong identity: client, MCP server revision, at Godot executable. Ang failure sa isa ay hindi ebidensyang unavailable ang iba. Gamitin ang connection diagram sa pagtukoy kung saan sisiyasatin ang problema: provider authentication, client configuration, lokal na tool process, o engine project.

I-inventory ang prerequisite nang hindi ito tahimik na binabago

Bago mag-install, siyasatin ang service requirement at pumili ng partikular na server version o revision para sa review. Kumpirmahing matatagpuan ng client process ang existing engine at runtime, hindi lamang ng interactive shell mo. Itala ang operating system at nilalayong project directory.

Suriin ang service installation procedure bago magpahintulot ng dependency change. Pangalanan ang runtime, server revision, at installation location, at panatilihin ang paraan para maibalik ang dating environment. Pagkatapos ng setup, itala ang resolved version sa halip na moving source URL lamang. Nakakatulong ito sa pag-reproduce ng gumaganang koneksyon kapag nag-upgrade sa susunod ang client o engine.

Gamitin ang documented local build entry point

Sinusuportahan ng service README ang source build na may build/index.js bilang client entry point at GODOT_PATH bilang tahasang executable override. Inilalarawan ng JSON sa ibaba ang built route na iyon gamit ang placeholder. Palitan ang bawat path ng nasuring lokal na installation at tiyaking mababasa ito ng client process.

Gamitin ang schema na tunay na sinusuportahan ng client mo. Hindi awtomatikong Codex configuration file ang generic na mcpServers object. Isalin lamang ito sa documented setting ng napiling client at ilayo ang model credential sa engine-tool block na ito. Makakatulong ang absolute Node path kapag iba ang environment ng GUI client sa terminal.

{
  "mcpServers": {
    "godot": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/reviewed-godot-mcp/build/index.js"],
      "env": {
        "GODOT_PATH": "/absolute/path/to/godot"
      }
    }
  }
}

I-verify muna ang read-only tool path

Siyasatin ang tool na ibinalik ng configured server sa halip na umasa sa naaalalang listahan. Binabanggit ng README ang get_godot_version at get_project_info bilang kapaki-pakinabang na inspection operation. Suriin ang natuklasang parameter schema, saka i-target lamang ang aprubadong project directory.

Ihambing ang ibinalik na engine at project information sa setup record. Panatilihin ang structured result at error. Huwag aprubahan ang scene creation hanggang matukoy ng observation ang nilalayong workspace. Kung connected ang badge ngunit hindi makumpleto ang read, hindi pa handa ang connection para sa gameplay experiment. Hindi ipinapakita ng badge lamang kung aling process o project ang naabot.

I-awtorisa ang isang reversible scene miniflow

Pagkatapos ma-verify ang read access, gumamit ng disposable na pag-aari mong scene para sa unang write. Itala ang orihinal na state nito, humingi ng isang nakikitang pagbabago, siyasatin ang saved scene, patakbuhin ito, kunin ang output, at ihinto ang project. Panatilihing magkasama ang nagresultang file diff at mga observation.

Ang acceptance condition ay chain mula sa hiniling na pagbabago tungo sa saved resource at nakikitang runtime behavior. Kapag nag-ulat ng success ang tool ngunit hindi nagbago ang scene, siyasatin ang project targeting at saved path bago sumubok ng ikalawang mutation. Buksan muli ang scene pagkatapos mag-save upang masaklaw ng check ang persistence pati ang kasalukuyang in-memory state.

I-diagnose ang failure sa tamang boundary

Kung nabigo ang process startup, siyasatin ang runtime at entry-point path. Kung hindi mahanap ang Godot, i-verify ang executable override mula sa environment ng client. Kung hindi ma-inspect ang project, tiyaking tumutukoy ang path sa directory na naglalaman ng project.godot at mababasa ito ng process.

Kapag tumatakbo na ang project, hawakan ang scene o gameplay error bilang engine issue na may reproduction context. Iwasang baguhin ang provider credential para lutasin ang lokal na path problem. Maingat na kunin ang server log: i-sanitize ang sensitibong filesystem detail bago ibahagi at panatilihing pansamantala ang detalyadong debug sa halip na itala nang walang pinipili ang bawat project operation.

Panatilihing makitid ang approval at network boundary

Maaaring baguhin ng engine tool ang gumaganang project o maglunsad ng code. Ibigay lamang ang pinakamaliit na angkop na directory at suriin ang mutation request hanggang maunawaan ang behavior. Huwag basta kopyahin ang malawak na auto-approval list dahil lamang lumilitaw ito sa example configuration.

Ituring ang imported script, plugin, at tool output bilang material na susuriin, hindi instruction na maaaring magpalawak ng authority. Nangangailangan ng tahasang desisyon ang package download, file deletion sa labas ng pag-aari mong scene, credential change, at publishing. Batayan lamang sa policy review ang unang matagumpay na miniflow, hindi dahilan upang payagan ang bawat susunod na tool action.

Itala ang limitasyon ng na-verify na setup

Dapat tukuyin ng kumpletong setup record ang server revision, client, engine version, project path, natuklasang tool, nakumpletong read, reversible change, at runtime result. Sabihin kung aling action ang hindi pa nasusubukan. Itabi ito sa game evidence sa halip na iharap bilang universal compatibility guarantee.

Ang susunod na layer ay ang production loop: magpatupad ng feature, i-reproduce ang behavior nito, mag-export, at subukan sa target platform. Sinusunod ng configuration dito ang service documentation at kailangan itong i-validate para sa napili mong client at version. Panatilihin ang limitadong result na iyon sa project, saka gamitin muli ang parehong inspection gate kapag nagbago ang server, engine, o client.

Mga madalas itanong