Persediaan Godot MCP

Fahami sambungan yang disediakan MCP

Coding-Solo/godot-mcp mendokumenkan alat untuk menjalankan projek Godot, mendapatkan output nyahpepijat dan mengendalikan scene. Ia ialah jambatan yang diselenggara projek, bukan perkhidmatan model atau edaran Godot rasmi. Ejen masih memerlukan akses model sendiri dan kebenaran tempatan yang sesuai.

Simpan tiga identiti dalam rekod persediaan: klien, semakan pelayan MCP dan boleh laku Godot. Kegagalan satu bukan bukti yang lain tidak tersedia. Gunakan rajah sambungan untuk menentukan tempat memeriksa masalah: pengesahan penyedia, konfigurasi klien, proses alat tempatan atau projek enjin.

Inventori prasyarat tanpa mengubahnya secara senyap

Sebelum pemasangan, periksa keperluan huluan dan pilih versi atau semakan pelayan khusus untuk semakan. Sahkan enjin dan runtime sedia ada boleh ditemui daripada proses klien, bukan shell interaktif sahaja. Rekodkan sistem operasi dan direktori projek yang dimaksudkan.

Semak prosedur pemasangan huluan sebelum membenarkan perubahan kebergantungan. Namakan runtime, semakan pelayan dan lokasi pemasangan serta kekalkan cara memulihkan persekitaran lama. Selepas persediaan, rekod versi diselesaikan dan bukan URL sumber bergerak sahaja. Ini membantu menghasilkan semula sambungan berfungsi apabila klien atau enjin dinaik taraf.

Gunakan titik masuk build tempatan yang didokumenkan

README huluan menyokong build sumber dengan build/index.js sebagai titik masuk klien dan GODOT_PATH sebagai penggantian boleh laku eksplisit. JSON di bawah menggambarkan laluan binaan itu dengan placeholder. Gantikan setiap laluan dengan pemasangan tempatan disemak dan sahkan proses klien boleh membacanya.

Gunakan skema yang sebenarnya disokong klien. Objek mcpServers generik bukan automatik fail konfigurasi Codex. Terjemahkan hanya melalui tetapan didokumenkan klien itu dan jauhkan kelayakan model daripada blok alat enjin ini. Laluan Node mutlak mungkin berguna apabila persekitaran klien GUI berbeza daripada 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"
      }
    }
  }
}

Sahkan laluan alat baca sahaja dahulu

Periksa alat yang dipulangkan pelayan dikonfigurasi dan bukannya bergantung pada senarai yang diingati. README menamakan get_godot_version dan get_project_info sebagai operasi pemeriksaan berguna. Semak skema parameter yang ditemui dan sasarkan hanya direktori projek diluluskan.

Bandingkan maklumat enjin dan projek yang dipulangkan dengan rekod persediaan. Simpan hasil dan ralat berstruktur. Jangan luluskan penciptaan scene sebelum pemerhatian mengenal pasti ruang kerja yang dimaksudkan. Jika klien menunjukkan lencana tersambung tetapi tidak dapat menyelesaikan bacaan ini, sambungan belum bersedia untuk eksperimen gameplay. Lencana sahaja tidak menunjukkan proses atau projek yang dicapai.

Benarkan miniflow scene yang boleh dibalikkan

Selepas akses baca disahkan, gunakan scene milik sendiri yang boleh dibuang untuk penulisan pertama. Rekod keadaan asalnya, minta satu perubahan kelihatan, periksa scene disimpan, jalankannya, ambil output dan hentikan projek. Simpan diff fail dan pemerhatian bersama.

Syarat penerimaan ialah rantaian daripada perubahan diminta kepada sumber disimpan dan tingkah laku runtime kelihatan. Apabila alat melaporkan berjaya tetapi scene tidak berubah, periksa sasaran projek dan laluan disimpan sebelum mutasi kedua. Buka semula scene selepas penyimpanan supaya pemeriksaan merangkumi ketekalan serta keadaan dalam memori semasa.

Diagnosis kegagalan pada sempadan yang betul

Jika permulaan proses gagal, periksa laluan runtime dan titik masuk. Jika Godot tidak ditemui, sahkan penggantian boleh laku daripada persekitaran klien. Jika projek tidak boleh diperiksa, pastikan laluan mengenal pasti direktori yang mengandungi project.godot dan boleh dibaca proses.

Setelah projek berjalan, kendalikan ralat scene atau gameplay sebagai isu enjin dengan konteks pembiakan. Jangan tukar kelayakan penyedia untuk membaiki masalah laluan tempatan. Tangkap log pelayan dengan teliti: bersihkan butiran sistem fail sensitif sebelum berkongsi dan jadikan nyahpepijat terperinci sementara, bukan merakam setiap operasi projek tanpa beza.

Kekalkan sempadan kelulusan dan rangkaian sempit

Alat enjin boleh mengubah projek berfungsi atau melancarkan kod. Berikan akses kepada direktori paling kecil yang sesuai dan semak permintaan mutasi sehingga tingkah laku difahami. Jangan salin senarai auto-kelulusan luas hanya kerana ia muncul dalam contoh konfigurasi.

Anggap skrip diimport, plugin dan output alat sebagai bahan untuk diperiksa, bukan arahan yang boleh meluaskan kuasa. Muat turun pakej, pemadaman fail di luar scene milik sendiri, perubahan kelayakan dan penerbitan memerlukan keputusan eksplisit. Miniflow berjaya pertama ialah asas untuk menyemak dasar, bukan alasan membenarkan setiap tindakan alat masa hadapan.

Rekod had persediaan yang telah disahkan

Rekod persediaan lengkap perlu mengenal pasti semakan pelayan, klien, versi enjin, laluan projek, alat ditemui, bacaan selesai, perubahan boleh balik dan hasil runtime. Nyatakan tindakan yang belum diuji. Simpan dengan bukti permainan dan bukannya membentangkan jaminan keserasian universal.

Lapisan seterusnya ialah gelung pengeluaran: laksanakan ciri, hasilkan semula tingkah laku, eksport dan uji pada platform sasaran. Konfigurasi ini mengikuti dokumentasi huluan dan mesti disahkan untuk klien serta versi dipilih. Simpan hasil berskop bersama projek dan gunakan semula pintu pemeriksaan sama apabila pelayan, enjin atau klien berubah.

Soalan lazim