godotswiftmcp

これは Swift で書かれた Godot 用の MCP サーバーです。これは https://github.com/ee0pdt/Godot-MCP の実装と over-the-wire 互換であるため、その実装の addons ディレクトリにある Godot サポート用インフラを使用しながら、この MCP サーバーを利用できます。

この実装を別に用意した理由は、Xogot を搭載した iPad ではプロセス外の MCP サーバーを実行できないためです。そのため、このバージョンにはプラグイン可能なプロバイダーインフラが含まれていますが、副次的な利点として、デスクトップ版の Godot でも動作し、自己完結型の MCP サーバーを生成します。

GodotSwiftMcp の使用方法

次の 3 つの作業が必要です。

• Swift を使用してサーバーをコンパイルする
• Godot プロジェクトに godot_mcp 拡張機能を追加する
• チャットアプリに MCP サーバーの使用方法を伝える

GodotSwiftpMcp サーバーのビルド

Swift ツールチェーンがインストールされている必要があります。インストールしたら、swift build と入力すると、.build ディレクトリの下にデバッグビルドが生成されます: .build/debug/godot-mcp-server-cli。

このコマンドは、チャットクライアントと Godot の間のブリッジとして機能します。

Godot プロジェクトに godot_mcp 拡張機能を追加する

Godot がリクエストを処理できるようにするには、プロジェクトに godot_mcp プロジェクトを追加する必要があります。

そのアドオンをインストールしていない場合は、'addons/godot_mcp' ディレクトリの内容を Godot プロジェクトにコピーし、Godot でアドオンを有効にすると、画面下部にタブが表示されるので、「Start Server」をタップしてください。

チャットクライアントの設定

これができたら、チャットクライアントが通信できるように設定できます。たとえば私の環境では、Claude デスクトップアプリを使用して、Settings->Developer に移動し、「Edit Config」をクリックして、次の内容を追加します:

{
  "mcpServers": {
    "godot": {
      "command": "/Users/miguel/bin/godot-mcp-server-cli",
      "args": [
      ]
    }
  }
}

そして Claude を再読み込みします。これ以降、そこから操作をリクエストできるようになります。

開発

このプロジェクトをビルドしたら、次のように MCP inspector を使用してテストできます:

bash$ npx @modelcontextprotocol/inspector

次に、inspector が表示する HTTP アドレスに接続し、次のように設定されていることを確認してください:

1. Transport Type: STDIO
2. Command: の後にコンパイルされたバイナリへのパス (私の場合: /Users/miguel/cvs/GodotSwiftMcp/.build/debug/godot-mcp-server-cli)

その後、起動して、利用可能な各種メソッドを検査できます。

内部構造

この実装をテストするために、WebSockets を使用して Godot と通信する GodotLocalSocketProvider を実装しました。

Xogot では、これが SwiftGodot を介して Godot と直接通信するインプロセス版に置き換えられます。

ベースラインの Godot-MCP に加えて、プルリクエスト #9 の追加機能も実装しました。

一般に、これは Node で書かれた MCP サーバーのドロップイン代替として機能するはずです。