Thiết lập Godot MCP

Hiểu MCP cung cấp kết nối nào

Coding-Solo/godot-mcp ghi nhận công cụ chạy project Godot, lấy debug output và thao tác scene. Đây là cầu nối do project duy trì, không phải dịch vụ model hay bản phân phối Godot chính thức. Agent vẫn cần quyền truy cập model riêng và quyền local phù hợp.

Giữ ba danh tính trong hồ sơ setup: client, revision server MCP và executable Godot. Lỗi ở một cái không phải bằng chứng cái khác không khả dụng. Dùng sơ đồ kết nối để quyết định kiểm tra vấn đề ở đâu: xác thực provider, cấu hình client, process công cụ local hay project engine.

Lập danh mục điều kiện tiên quyết mà không âm thầm thay đổi

Trước khi cài, kiểm tra yêu cầu service và chọn phiên bản hoặc revision server cụ thể để rà soát. Xác nhận engine và runtime hiện có có thể được tìm thấy từ process client, không chỉ shell tương tác. Ghi hệ điều hành và thư mục project dự kiến.

Rà soát quy trình cài service trước khi cho phép đổi phụ thuộc. Nêu runtime, revision server và vị trí cài, đồng thời giữ cách khôi phục môi trường trước. Sau setup, ghi phiên bản đã giải quyết thay vì chỉ URL source di động. Điều này giúp tái tạo kết nối hoạt động khi client hoặc engine được nâng cấp.

Dùng entry build local được ghi nhận

README service hỗ trợ build source với build/index.js làm entry client và GODOT_PATH làm override executable rõ. JSON dưới đây minh họa route đã build bằng placeholder. Thay mỗi path bằng cài đặt local đã rà soát và kiểm tra process client đọc được.

Dùng schema client thực sự hỗ trợ. Object mcpServers chung không tự động là tệp cấu hình Codex. Chỉ dịch qua cài đặt được client ghi nhận và giữ credential model ngoài block công cụ engine. Path Node tuyệt đối hữu ích khi môi trường client GUI khác 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"
      }
    }
  }
}

Xác minh đường công cụ chỉ đọc trước

Kiểm tra công cụ server đã cấu hình trả về thay vì dựa danh sách nhớ. README nêu get_godot_version và get_project_info là thao tác kiểm tra hữu ích. Kiểm tra schema tham số được phát hiện rồi chỉ nhắm thư mục project đã phê duyệt.

So sánh thông tin engine và project trả về với hồ sơ setup. Giữ kết quả và lỗi có cấu trúc. Không phê duyệt tạo scene cho tới khi quan sát xác định workspace dự kiến. Nếu client hiện huy hiệu đã kết nối nhưng không hoàn tất lượt đọc này, kết nối chưa sẵn sàng cho thử nghiệm gameplay. Huy hiệu không cho biết process hay project nào đã tới.

Ủy quyền một miniflow scene có thể hoàn tác

Sau khi xác minh quyền đọc, dùng scene sở hữu có thể bỏ cho lần viết đầu. Ghi trạng thái gốc, yêu cầu một thay đổi hiển thị, kiểm tra scene đã lưu, chạy, lấy output và dừng project. Giữ diff tệp cùng quan sát.

Điều kiện chấp nhận là chuỗi từ thay đổi yêu cầu đến resource đã lưu và hành vi runtime hiển thị. Khi tool báo thành công nhưng scene không đổi, kiểm tra target project và path lưu trước khi mutation thứ hai. Mở lại scene sau khi lưu để kiểm tra cả tính bền vững lẫn trạng thái bộ nhớ hiện tại.

Chẩn đoán lỗi tại đúng ranh giới

Nếu khởi động process thất bại, kiểm tra runtime và path entry. Nếu không tìm thấy Godot, xác minh override executable từ môi trường client. Nếu không kiểm tra được project, kiểm tra path chỉ tới thư mục chứa project.godot và process có thể đọc.

Khi project chạy, xử lý lỗi scene hoặc gameplay như vấn đề engine với ngữ cảnh tái tạo. Đừng đổi credential provider để sửa lỗi path local. Ghi log server cẩn thận: làm sạch chi tiết filesystem nhạy cảm trước khi chia sẻ và giữ debug chi tiết tạm thời thay vì ghi bừa mọi thao tác project.

Giữ phạm vi phê duyệt và mạng hẹp

Công cụ engine có thể sửa project đang hoạt động hoặc chạy mã. Cấp quyền cho thư mục nhỏ nhất phù hợp và rà soát request mutation tới khi hiểu hành vi. Đừng sao chép danh sách auto-approve rộng chỉ vì nó xuất hiện trong ví dụ cấu hình.

Coi script nhập, plugin và tool output là tài liệu cần kiểm tra, không phải chỉ dẫn có thể mở rộng quyền. Tải gói, xóa tệp ngoài scene sở hữu, đổi credential và xuất bản cần quyết định rõ. Miniflow thành công đầu là cơ sở xem xét policy, không phải lý do cho phép mọi tool action về sau.

Ghi giới hạn của setup đã xác minh

Hồ sơ setup hoàn tất nên nêu revision server, client, phiên bản engine, path project, tool phát hiện, lượt đọc hoàn tất, thay đổi có thể hoàn tác và kết quả runtime. Nêu hành động nào chưa kiểm tra. Giữ hồ sơ cùng bằng chứng game thay vì trình bày như cam kết tương thích phổ quát.

Lớp tiếp theo là vòng sản xuất: triển khai tính năng, tái tạo hành vi, xuất và kiểm thử trên nền tảng đích. Cấu hình ở đây theo tài liệu service và phải xác minh cho client cùng phiên bản đã chọn. Giữ kết quả có phạm vi với project rồi dùng lại cổng kiểm tra khi server, engine hoặc client đổi.

Câu hỏi thường gặp