راه‌اندازی Godot MCP

بفهمید MCP کدام اتصال را فراهم می‌کند

Coding-Solo/godot-mcp ابزارهایی برای اجرای پروژه‌های Godot، دریافت خروجی debug و کار روی صحنه‌ها مستند می‌کند. این bridgeای تحت نگهداری پروژه است، نه سرویس مدل یا توزیع رسمی Godot. agent همچنان به دسترسی مدل خودش و مجوزهای محلی مناسب نیاز دارد.

سه هویت را در رکورد setup نگه دارید: کلاینت، revision سرور MCP و executable Godot. شکست یکی شواهد در دسترس نبودن دیگری نیست. از نمودار اتصال برای تعیین محل بررسی مشکل استفاده کنید: احراز هویت ارائه‌دهنده، پیکربندی کلاینت، فرایند ابزار محلی یا پروژه موتور.

پیش‌نیازها را بدون تغییر بی‌صدا فهرست کنید

پیش از نصب نیازمندی‌های service را بررسی و نسخه یا revision مشخص سرور را برای بازبینی انتخاب کنید. مطمئن شوید موتور و runtime از فرایند کلاینت پیدا می‌شوند، نه فقط از shell تعاملی شما. سیستم‌عامل و پوشه پروژه موردنظر را ثبت کنید.

پروسه نصب service را پیش از اجازه تغییر وابستگی بررسی کنید. runtime، revision سرور و محل نصب را نام ببرید و راهی برای بازگرداندن محیط قبلی نگه دارید. پس از setup نسخه‌های resolveشده را ثبت کنید، نه فقط URL متحرک source. این کار بازتولید اتصال سالم را پس از ارتقای کلاینت یا موتور آسان می‌کند.

نقطه ورود build محلی مستند را استفاده کنید

README service از build source با build/index.js به‌عنوان entry point کلاینت و GODOT_PATH به‌عنوان override صریح executable پشتیبانی می‌کند. JSON زیر همان مسیر ازپیش‌ساخته را با placeholder نشان می‌دهد. هر مسیر را با نصب محلی بازبینی‌شده جایگزین و بررسی کنید فرایند کلاینت می‌تواند آن را بخواند.

schemaای را به‌کار ببرید که کلاینت واقعاً پشتیبانی می‌کند. object عمومی mcpServers خودکار فایل پیکربندی Codex نیست. فقط از مسیر تنظیمات مستند همان کلاینت ترجمه کنید و اعتبارنامه مدل را از این بلوک ابزار موتور بیرون نگه دارید. مسیر مطلق Node وقتی محیط کلاینت GUI با 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"
      }
    }
  }
}

ابتدا مسیر ابزار فقط‌خواندنی را تأیید کنید

به‌جای اتکا به فهرست به‌یادمانده، ابزارهای برگردانده‌شده سرور پیکربندی‌شده را بررسی کنید. README، get_godot_version و get_project_info را عملیات مفید بازرسی نام می‌برد. schema پارامتر کشف‌شده آن‌ها را بررسی و فقط پوشه پروژه تأییدشده را هدف بگیرید.

اطلاعات موتور و پروژه برگشتی را با رکورد setup مقایسه کنید. نتیجه‌ها و خطاهای ساختاریافته را حفظ کنید. تا وقتی مشاهده workspace موردنظر را مشخص نکرده، ایجاد صحنه را تأیید نکنید. نشان اتصال بدون تکمیل این read یعنی اتصال برای آزمایش گیم‌پلی آماده نیست. badge به‌تنهایی نمی‌گوید کدام فرایند یا پروژه رسیده است.

یک miniflow صحنه قابل‌بازگشت را مجاز کنید

پس از تأیید دسترسی خواندن، برای نخستین نوشتن از صحنه‌ای دورریختنی و متعلق به خود استفاده کنید. وضعیت اصلی را ثبت، یک تغییر دیداری درخواست، صحنه ذخیره‌شده را بررسی، آن را اجرا، خروجی را دریافت و پروژه را متوقف کنید. diff فایل و مشاهده‌ها را کنار هم نگه دارید.

شرط پذیرش زنجیره‌ای از تغییر خواسته‌شده تا منبع ذخیره‌شده و رفتار runtime قابل‌مشاهده است. وقتی ابزار موفقیت می‌گوید اما صحنه تغییر نکرده، پیش از mutation دوم هدف پروژه و مسیرهای ذخیره را بررسی کنید. پس از ذخیره صحنه را دوباره باز کنید تا persistence در کنار وضعیت حافظه بررسی شود.

شکست‌ها را در مرز درست تشخیص دهید

اگر شروع فرایند شکست می‌خورد، مسیرهای runtime و entry point را بررسی کنید. اگر Godot پیدا نمی‌شود، override executable را از محیط کلاینت تأیید کنید. اگر پروژه بازرسی نمی‌شود، بررسی کنید مسیر به پوشه دارای project.godot اشاره می‌کند و فرایند به آن دسترسی خواندن دارد.

پس از اجرای پروژه، خطاهای صحنه یا گیم‌پلی را با زمینه بازتولید به‌عنوان مسئله موتور مدیریت کنید. برای اصلاح مشکل مسیر محلی، اعتبارنامه ارائه‌دهنده را تغییر ندهید. log سرور را با دقت ثبت کنید: جزئیات حساس فایل‌سیستم را پیش از اشتراک پاک‌سازی و debug دقیق را موقت نگه دارید.

مرزهای تأیید و شبکه را محدود نگه دارید

ابزار موتور می‌تواند پروژه کاری را تغییر یا کد را اجرا کند. دسترسی را به کوچک‌ترین پوشه مناسب بدهید و تا فهم رفتار، درخواست‌های تغییر را بازبینی کنید. فقط چون فهرست‌های auto-approval در نمونه‌ای دیده می‌شوند آن‌ها را گسترده کپی نکنید.

script، plugin و خروجی ابزار importشده را ماده قابل‌بررسی بدانید، نه دستورهایی که می‌توانند اختیار را گسترش دهند. دانلود package، حذف فایل بیرون از صحنه متعلق به شما، تغییر اعتبارنامه و انتشار به تصمیم‌های صریح نیاز دارند. نخستین miniflow موفق مبنای بازبینی policy است، نه دلیلی برای اجازه همه کنش‌های آینده ابزار.

حدود setup تأییدشده را ثبت کنید

رکورد setup کامل باید revision سرور، کلاینت، نسخه موتور، مسیر پروژه، ابزارهای کشف‌شده، read تکمیل‌شده، تغییر قابل‌بازگشت و نتیجه runtime را مشخص کند. بگویید کدام کنش‌ها هنوز آزمایش نشده‌اند. آن را کنار شواهد بازی نگه دارید و تضمین سازگاری عمومی ارائه نکنید.

لایه بعدی حلقه تولید است: قابلیت را پیاده کنید، رفتار را بازتولید، export و روی پلتفرم هدف آزمون کنید. پیکربندی اینجا از مستندات service پیروی می‌کند و باید برای کلاینت و نسخه‌های انتخاب‌شده اعتبارسنجی شود. نتیجه محدود را کنار پروژه نگه دارید و هر بار سرور، موتور یا کلاینت تغییر کرد همان دروازه بازرسی را دوباره اجرا کنید.

پرسش‌های پرتکرار