GodotForgeMCP / godot-forge

godot-forge は、Godot 4.5→4.8-dev 向けの安全な、プログレッシブ・ディスクロージャー方式の MCP サーバー + Godot エディタのアドオン + MCP App キャンバスとして開発中です。

現在のステータス: M0 スケルトン。

現在動作するもの

• TypeScript/Node.js 20+ の MCP サーバースケルトン。

• stdio 上での MCP 2026-07-28 のネゴシエーション。

• MCP ルーティングヘッダーを備えたステートレスな HTTP JSON-RPC スケルトン。

• Godot バイナリ、プロジェクトルート、C# プロジェクトファイル、GDScript LSP TCP 6005 のキャパビリティプローブ。

• 常時有効なツールはちょうど 5 つ:

  • forge_search_tools

  • forge_describe_tool

  • forge_run

  • forge_inspect

  • forge_task_status

• M0 スタブアクション用の永続的なタスクシムストア。

• ツールのトークン予算計測ゲート。

• MCP ネゴシエーションを検証し、Ollama が起動していない場合に適切に報告するローカルクライアント/Ollama スモークスクリプト。

Related MCP server: GoPeak

クイックスタート

npm install
npm run build
npm test
npm run smoke
npm run probe

MCP stdio サーバーとして実行:

node dist/index.js

HTTP スケルトンを実行:

node dist/index.js --http --host 0.0.0.0 --port 3333

クライアント設定の例は docs/M0_RUNBOOK.md を参照してください。

設計ドキュメント

• docs/PRIOR_ART.md

• docs/ARCHITECTURE.md

• docs/TOOLS.md

• docs/DECISIONS_AND_SCOPE.md

• docs/M0_RUNBOOK.md

ライセンス

MIT ライセンス。他プロジェクト由来のコード、または他プロジェクトをベースにしたコードが組み込まれる際、先行技術へのクレジットと実装由来の表示は維持されます。