Godot MCP setup

MCP কোন connection দেয় বুঝুন

Coding-Solo/godot-mcp Godot project run, debug output retrieve ও scene operate করার tool document করে। এটি project-maintained bridge, model service বা official Godot distribution নয়। Agent-এর নিজের model access ও উপযুক্ত local permission এখনও দরকার।

Setup record-এ তিনটি identity রাখুন: client, MCP server revision ও Godot executable। একটির failure অন্যটি unavailable তার evidence নয়। Problem কোথায় inspect করবেন ঠিক করতে connection diagram ব্যবহার করুন: provider authentication, client configuration, local tool process অথবা engine project।

Prerequisite inventory করুন, নীরবে পরিবর্তন নয়

Installation-এর আগে service requirement inspect করুন এবং review-এর জন্য specific server version বা revision select করুন। Client process থেকে existing engine ও runtime পাওয়া যায় কি না confirm করুন, শুধু interactive shell-এ নয়। Operating system ও intended project directory record করুন।

Dependency change allow করার আগে service installation procedure review করুন। Runtime, server revision ও installation location নাম দিন এবং previous environment restore করার উপায় রাখুন। Setup-এর পরে moving source URL নয়, resolved version record করুন। Client বা engine upgrade হলে working connection reproduce করতে এটি সাহায্য করে।

Documented local build entry point ব্যবহার করুন

Service README build/index.js path-কে client entry point এবং GODOT_PATH-কে explicit executable override হিসেবে source build support করে। নিচের JSON already-built route-এর illustration, placeholder-সহ। প্রতিটি path reviewed local installation দিয়ে replace করুন এবং client process এটি read করতে পারে কি না check করুন।

Client আসলে যে schema support করে সেটিই ব্যবহার করুন। Generic mcpServers object automatically Codex configuration file নয়। Client-এর documented setting দিয়ে কেবল সেই পথে translate করুন এবং model credential এই engine-tool block-এর বাইরে রাখুন। GUI client-এর environment terminal থেকে আলাদা হলে absolute Node path কার্যকর হতে পারে।

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

আগে read-only tool path verify করুন

মনে থাকা list-এর ওপর নির্ভর না করে configured server যে tool ফেরত দেয় তা inspect করুন। README get_godot_version ও get_project_info-কে useful inspection operation বলে। Discovered parameter schema check করুন, তারপর approved project directory-তেই target করুন।

Returned engine ও project information setup record-এর সঙ্গে তুলনা করুন। Structured result ও error preserve করুন। Observation intended workspace identify না করা পর্যন্ত scene creation approve করবেন না। Client connected badge দেখালেও এই read complete করতে না পারলে gameplay experiment-এর জন্য connection ready নয়। Badge একা কোন process বা project reached তা দেখায় না।

একটি reversible scene miniflow authorize করুন

Read access verify হওয়ার পরে first write-এর জন্য disposable owned scene ব্যবহার করুন। Original state record করুন, একটি visible change চাইুন, saved scene inspect করুন, run করুন, output retrieve করে project stop করুন। Resulting file diff ও observation একসঙ্গে রাখুন।

Acceptance condition হলো requested change থেকে saved resource এবং visible runtime behavior পর্যন্ত chain। Tool success report করলেও scene বদলালে না, দ্বিতীয় mutation-এর আগে project targeting ও saved path inspect করুন। Save-এর পরে scene reopen করুন, যাতে current in-memory state-এর পাশাপাশি persistence-ও check হয়।

সঠিক boundary-তে failure diagnose করুন

Process startup fail হলে runtime ও entry-point path inspect করুন। Godot locate না হলে client environment থেকে executable override verify করুন। Project inspect না হলে path project.godot থাকা directory identify করে এবং process-এর read access আছে কি না check করুন।

Project run করার পরে scene বা gameplay error-কে reproduction context-সহ engine issue ধরুন। Local path problem ঠিক করতে provider credential বদলাবেন না। Server log সাবধানে capture করুন: share করার আগে sensitive filesystem detail sanitize করুন এবং নির্বিচারে প্রতিটি project operation record না করে detailed debug temporary রাখুন।

Approval ও network boundary narrow রাখুন

Engine tool working project বদলাতে বা code launch করতে পারে। Smallest appropriate directory-তে access দিন এবং behavior বোঝা পর্যন্ত mutation request review করুন। Example configuration-এ broad auto-approval list দেখা যায় বলে copy করবেন না।

Imported script, plugin ও tool output inspect করার material, authority expand করার instruction নয়। Package download, owned scene-এর বাইরে file deletion, credential change ও publishing explicit decision চায়। প্রথম successful miniflow policy review-এর ভিত্তি, ভবিষ্যতের প্রতিটি tool action allow করার কারণ নয়।

Verified setup-এর limit record করুন

Completed setup record-এ server revision, client, engine version, project path, discovered tool, completed read, reversible change ও runtime result identify করা উচিত। কোন action untested আছে state করুন। Game evidence-এর সঙ্গে রাখুন, universal compatibility guarantee হিসেবে নয়।

পরের layer production loop: feature implement, behavior reproduce, export এবং target platform-এ test। এখানকার configuration service documentation অনুসরণ করে এবং selected client ও version-এর জন্য validate করতে হবে। Scoped result project-এর সঙ্গে রাখুন এবং server, engine বা client বদলালে একই inspection gate reuse করুন।

সাধারণ প্রশ্ন