もがき系プログラマの日常

もがき系エンジニアの勉強したこと、日常のこと、気になっている技術、備忘録などを紹介するブログです。

Godot MCPに繋がらないので原因プロセスをkillしまくったけど見当違いだった。

はじめに

こんばんは。

最近TLに「Claude Codeで3Dモデル作った」「Unity MCPでゲーム作らせた」系のツイートがよく流れてくるので、自分でも試してみようと思いました。

ゲーム開発でインストールしてたGodot MCPでやってみました。

……のですが、繋がるまでに1時間くらい溶かしました。もう解決済みですが、備忘録として残しておきます。

準備

Godotのプラグインはプロジェクト単位なので、新規プロジェクトを作った直後は addons/ が空です。まずアドオンを入れる必要があります。

npx @satelliteoflove/godot-mcp --install-addon <プロジェクトのパス>

そのあと プロジェクト設定 → プラグイン → 有効化 にチェック。

これでエディタ側が ws://127.0.0.1:6550 で待ち受けを始めます。有効化していないと、いつまで待っても以下のエラーになります。

Error: Not connected to Godot
Status: Cannot reach Godot at ws://127.0.0.1:6550

本題

有効化してGodotを再起動したところ、エラーの内容が変わりました。

Error: Not connected to Godot
Status: Another client is already connected to Godot
Details: 5 connection attempts rejected
Suggestion: Only one client can drive the Godot bridge at a time.

Godotのブリッジは同時に1クライアントしか掴めない仕様のようです。

心当たりはありました。以前に別のセッションで godot-mcp を触っていたので、そのプロセスが残っているのだろうと。

疑い1: 居残りプロセス

$ ps aux | grep godot-mcp
User  68268  node .../node_modules/.bin/godot-mcp
User  68261  node .../node_modules/.bin/godot-mcp
User  68154  npm exec @satelliteoflove/godot-mcp
User  68157  npm exec @satelliteoflove/godot-mcp
User  68151  /Applications/Claude.app/Contents/Helpers/disclaimer ... godot-mcp
User  68148  /Applications/Claude.app/Contents/Helpers/disclaimer ... godot-mcp
User  85611  node .../node_modules/.bin/godot-mcp   ← 金曜起動の居残り
User  85527  npm exec @satelliteoflove/godot-mcp

いっぱいいますね。

わかりやすい容疑者として、金曜から動き続けている 85611 を落としました。

結果、変わらず。しかも connection attempts rejected の回数が 5 → 9 に増えているので、リトライは続いているが誰かがまだ掴んでいる、という状況でした。

疑い2: lsof で掴んでいる本人を特定する

$ lsof -nP -iTCP:6550 | grep ESTABLISHED
Godot  56259  ... TCP 127.0.0.1:6550->127.0.0.1:63891 (ESTABLISHED)
node   68268  ... TCP 127.0.0.1:63891->127.0.0.1:6550 (ESTABLISHED)

68268 が掴んでいて、自分は弾かれている側なので、これは自分ではないはず...

killしましたが結果、また変わらず(rejected は 12 に増加)。もう一度見てみると。

$ lsof -nP -iTCP:6550 | grep ESTABLISHED
Godot  56259  ... TCP 127.0.0.1:6550->127.0.0.1:63900 (ESTABLISHED)
node   68261  ... TCP 127.0.0.1:63900->127.0.0.1:6550 (ESTABLISHED)

ポート番号が 63891 → 63900 に変わっています。つまりスロットは一度空いた。そして別の 68261 が即座に取っているという感じだと思います。

疑い3: 二重登録では?

$ cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | grep -A3 godot
    "godot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@satelliteoflove/godot-mcp"
      ],

設定は1個だけでした。二重登録説ではなさそうです。

見落としていたこと

ここでようやく、lsof の出力を読み違えていたことに気づきます。

ESTABLISHED が毎回1組しか出ていない。

本当に2つのクライアントが椅子を取り合っているなら、負けている側のソケットも見えるはずです。

Claudeに相談すると、一旦Godot落としてみては?という話になりました。

解決

Godotを終了します。

$ lsof -nP -iTCP:6550
(何も出ない)

きれいに空きました。この状態でGodotを起動してプロジェクトを開き直すと、あっさり繋がりました。

{
  "godot_version": "4.6-stable (official)",
  "main_screen": "3D",
  "current_scene": null,
  "is_playing": false,
  "open_scenes": []
}

kill しまくったプロセスは、全部が空振りでした。

終わりに

「Another client is already connected」と言われたのでクライアント側を疑ったのですが、原因はサーバー側(Godot)でした。エラーメッセージが指している方向と、実際の原因の場所が違うパターンです。

以前ハマった Laravelのmemcached ttl の記事 も、コードは正しくてコンテナのTZが犯人という話だったので、また同じ構図をやってしまいました。

学習していません...

ちょっと休憩して、次は3D簡単に作ってみます。

現場からは以上です。