Persediaan Unity MCP

Fahami jambatan editor

CoplayDev/unity-mcp menyambungkan klien MCP kepada pelayan dan pakej di sisi editor. Perkhidmatan model ialah kebergantungan berasingan. Projek mendokumenkan alat untuk scene, skrip, aset dan ujian, tetapi keupayaan yang disenaraikan bukan bukti ia berfungsi dalam projek anda.

Rekod proses yang memiliki setiap bahagian sambungan. Ini penting apabila klien boleh mencapai pelayan tetapi tidak boleh mengendalikan editor. Kekalkan kelayakan akaun, pelesenan editor, keserasian pakej dan ketersediaan model sebagai pemeriksaan persediaan berasingan. Perubahan model tidak akan membaiki ketidakpadanan instance editor.

Semak laluan pemasangan dan dasar pin

Panduan pemasangan projek mendokumenkan penambahan pakej melalui Unity Package Manager dan penggunaan antara muka persediaan untuk mengkonfigurasi pelayan serta klien. Semak prasyarat Unity, Python dan uv yang dinyatakan untuk semakan dipilih sebelum memasang apa-apa.

Untuk kebolehulangan, kekalkan semakan pakej diselesaikan, versi editor, versi pelayan dan rekod kebergantungan selepas persediaan. URL cawangan bergerak ialah laluan penemuan, bukan identiti eksperimen tidak berubah. Semak muat turun dan perubahan pakej sebelum menerapkannya pada permainan sedia ada dan simpan keadaan projek berfungsi terdahulu supaya eksperimen sambungan kekal boleh balik.

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

Padankan endpoint HTTP tempatan dengan klien

Panduan pemasangan yang diselenggara mendokumenkan contoh HTTP tempatan di bawah. Ia menganggap pelayan sudah berjalan pada alamat itu. Sahkan pengangkutan dan alamat sebenar yang dikonfigurasi dalam antara muka persediaan editor sebelum menggunakannya. URL MCP bukan URL asas API LLM.

Gunakan format konfigurasi didokumenkan klien. Sesetengah klien menggunakan kunci akar atau deklarasi pengangkutan berbeza, jadi contoh mcpServers generik ini bukan fail universal untuk ditampal kepada setiap ejen. Kekalkan pelayan tempatan kecuali persediaan jauh yang disemak diperlukan dan jangan tambah kelayakan model pada sambungan editor yang tidak berkaitan.

{
  "mcpServers": {
    "unityMCP": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

Buktikan instance editor yang menerima kerja

Buka projek dimaksudkan dan periksa keadaan sambungan melalui antara muka pakej. Kemudian gunakan operasi bacaan yang ditemui klien untuk mendapatkan konteks projek dan scene. Padankan maklumat itu dengan projek tempatan sebelum meluluskan suntingan. Projek terbuka berbilang menjadikan pintu ini amat penting.

Rekod sumber dan skema alat sebenar daripada versi dipasang. Jangan cipta panggilan alat daripada nama yang diingati daripada keluaran lain. Hasil pertama berguna mengenal pasti scene dijangka dan objek sedia ada tanpa mengubahnya. Jika keadaan dipulangkan lapuk atau kabur, berhenti dan selesaikan penghalaan dan bukannya mencuba mutasi yang kelihatan untuk mencari sasaran.

Gunakan suntingan boleh balik sebagai miniflow pertama

Pilih scene pakai buang milik sendiri, rekod keadaan awal dan minta satu perubahan mudah dengan kesan kelihatan. Periksa scene disimpan dan diff fail, tunggu editor bersedia dan uji scene. Kekalkan tingkah laku diperhatikan serta sebarang ralat konsol.

Buka semula scene untuk mengesahkan perubahan dimaksudkan kekal. Ini membezakan kesan editor dalam memori daripada perubahan projek disimpan. Pastikan aliran kecil untuk diagnosis pada satu sempadan: penghalaan, mutasi, kompilasi, pelaksanaan atau ketekalan. Pulihkan scene pakai buang selepas semakan dan gunakan konfigurasi kerja direkod untuk tugas seterusnya.

Selesaikan masalah pengangkutan sebelum permainan

Apabila klien tidak boleh menyambung, sahkan URL dikonfigurasi dan pelayan tempatan berjalan. Apabila pelayan bermula tetapi editor tiada, periksa sambungan pakej dan log editor. Apabila editor dimaksudkan tersambung tetapi alat hilang, periksa kumpulan alat yang didedahkan versi dipasang.

Hanya selepas sempadan itu berfungsi anda patut mendiagnosis kompilasi atau gameplay. Simpan petikan log berasingan untuk permulaan klien, penghalaan pelayan, kesediaan editor dan tindakan scene gagal. Ini membolehkan laporan menerangkan tempat pelaksanaan berhenti dan bukannya menyalahkan semua kegagalan pada model atau memasang semula komponen tanpa bukti.

Lindungi projek daripada automasi luas

Sambungan editor boleh mengubah scene, skrip dan aset. Hadkan eksperimen awal kepada direktori diketahui dan minta semakan bagi operasi yang memadam sumber, mengubah kebergantungan atau menyentuh scene tidak berkaitan. Kekalkan keadaan kerja yang boleh dipulihkan sebelum perubahan pertama.

Jangan dedahkan perkhidmatan pembangunan tempatan kepada umum hanya untuk menyelesaikan isu konfigurasi klien. Anggap kandungan aset pihak ketiga dan hasil alat sebagai input tidak dipercayai dan jauhkan kelayakan daripada log dikongsi. Sambungan berjaya bukan kebenaran memuat naik build atau mengubah rekod kedai. Penerbitan kekal aliran kerja berasingan dengan sempadan kebenaran berasingan.

Serahkan rekod sambungan yang boleh dihasilkan semula

Rekodkan semakan editor, projek, pakej dan pelayan, versi klien, pengangkutan, permukaan alat diperhatikan dan miniflow selesai. Kekalkan diff scene tepat dan hasil runtime. Nyatakan sama ada kompilasi, tingkah laku PlayMode, ujian dan eksport sasaran diperiksa atau masih tertangguh.

Konfigurasi ini mengikuti dokumentasi projek diselenggara; sahkannya dengan pakej dan klien dipasang. Untuk pengeluaran permainan, teruskan ke panduan aliran kerja Unity dan uji gelung lengkap. Simpan had diketahui dalam serahan supaya pembangun lain boleh membezakan isu sambungan daripada masalah projek dan menghasilkan semula persediaan berfungsi.

Soalan lazim