Skillget

godot-loop-mcp

mcp
Security Audit
Warn
Health Warn
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Warn
  • fs module — File system access in packages/server/package.json
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool is an MCP bridge server that connects AI models and external clients to the Godot game engine. It allows users to observe, edit, run, and debug Godot projects externally via a local TCP connection.

Security Assessment
Overall risk: Medium. The tool operates over a local TCP bridge to interact with your Godot project. It requires file system access (noted in the server package) to read and modify your project files, scenes, and scripts. While it does feature dangerous tool gating, security levels, and audit logs, it does allow executing scene runs and taking screenshots. No hardcoded secrets or dangerous account permissions were detected, but users should be aware that the tool can directly manipulate their local development environment.

Quality Assessment
The project is under active development, with its most recent push occurring today. It uses the permissive Apache-2.0 license and includes comprehensive CI/CD testing across Windows and Ubuntu. However, community trust and visibility are currently very low. With only 5 GitHub stars, the tool is extremely new, meaning potential bugs or security edge cases might not yet be fully exposed or tested by a wider audience.

Verdict
Use with caution — the project is actively maintained and well-structured, but its very low community adoption means it should be vetted internally before integrating into critical workflows.
SUMMARY

Godot 4.4+ MCP development loop with an editor addon, external server, and local TCP bridge.

README.md

godot-loop-mcp

English README

godot-loop-mcp は Godot 4.4+ 向けの MCP ベース開発支援ツールです。
Godot Editor Addon と外部 MCP server をローカル TCP bridge で接続し、AI や外部クライアントから Godot project の観測、編集、実行、検証を行えるようにします。

主な機能

  • editor / runtime の状態観測
  • scene / node / script の編集
  • play_scene / stop_scene による実行ループ
  • project search, UID, selection, focus
  • tests, prompts, resource templates
  • capability-gated screenshot / runtime debug surface
  • security level, audit log, dangerous tool gating
  • GitHub Release と npm package による配布

サポート範囲

  • Godot: 4.4+
  • Node.js: 22.14.0+
  • npm package: @godot-loop-mcp/server
  • CI coverage: 4.4.1-stable + current latest stable 4.x on Windows, nightly also on Ubuntu
  • 最新公開版:

インストール

1. Addon

GitHub Release の godot-loop-mcp-addon-*.zip を展開し、Godot project の addons/godot_loop_mcp/ に配置します。

その後、Godot の Project Settings > Plugins で Godot Loop MCP を有効化します。

2. Server

npm install --save-dev @godot-loop-mcp/server

Godot project root で起動する場合:

npx @godot-loop-mcp/server

project root 以外から起動する場合は GODOT_LOOP_MCP_REPO_ROOT を設定します。

クイックスタート

server:

npx @godot-loop-mcp/server

Godot:

godot_console.exe --headless --editor --quit-after 240 --path .

期待値:

  • addon log に Bridge handshake completed
  • server log に Addon handshake completed

リポジトリ構成

addons/godot_loop_mcp/   Godot Editor Addon
packages/server/         MCP bridge server
docs/                    運用・調査・配布ドキュメント
.github/workflows/       CI/CD

開発

npm ci --prefix packages/server
npm --prefix packages/server run typecheck

代表的な smoke:

$env:GODOT_LOOP_MCP_GODOT_BIN = (Get-Command godot_console.exe).Source
npm --prefix packages/server run smoke:m1
npm --prefix packages/server run smoke:m2
npm --prefix packages/server run smoke:m3
npm --prefix packages/server run smoke:m4
npm --prefix packages/server run smoke:m6

GUI 前提の確認:

$env:GODOT_LOOP_MCP_GODOT_GUI_BIN = (Get-Command godot.exe).Source
npm --prefix packages/server run smoke:m4:gui

ドキュメント

現在の制約

  • Godot 4.5+ では editor console capture を優先し、4.4 では .godot/mcp fallback を返します
  • screenshot と runtime.debug は capability-gated です
  • dangerous tools は explicit opt-in と allowlist 前提です
  • Godot Asset Library への公開は手動 handoff です

ライセンス

Apache-2.0

Reviews (0)

No results found