Godot MCP

あなたのAIアシスタントにGodotエディタへの完全なアクセスを提供します。

Claude、Cursor、またはMCP互換のAIを使えば、ゲームをより速く開発できます。コピー＆ペーストも、コンテキストの切り替えも不要です。AIはシーン、スクリプト、ノード、プロジェクト設定を直接読み取り、書き込み、操作します。

Godot 4.x · 42ツール · インタラクティブなプロジェクトビジュアライザー · MITライセンス

クイックスタート

0. Node.jsをインストール（初回セットアップ）

nodejs.org からインストーラーをダウンロードして実行します（LTS版）。標準のインストーラーなので、ターミナルは不要です。

1. Godotプラグインをインストール

Godotエディタ内で、上部のAssetLibタブをクリック → "mcp" を検索 → "Godot AI Assistant tools MCP" を見つけて → インストール。

次に Project → Project Settings → Plugins に移動し、Godot MCP プラグインを有効にします。

2. AIクライアントにサーバー設定を追加

Claude Desktop — Settings → Developer → Edit Config → 設定ファイルを開いて貼り付けます：

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Cursor — Settings → MCP → Add Server:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Claude Code — ターミナルで実行：

claude mcp add godot -- npx -y godot-mcp-server

MCP互換の任意のクライアント（Cline、Windsurfなど）で動作します。

3. AIクライアントを再起動

Claude Desktop / Cursor / お使いのクライアントを閉じて再度開き、新しい設定を読み込ませます。

4. Godotプロジェクトを再起動

GodotエディタでRestart Projectをクリックします。右上隅を確認してください — MCP Connectedが緑色で表示されるはずです。準備完了です。

Related MCP server: Godot MCP Bridge

できること

6つのカテゴリにわたる42ツール

インタラクティブビジュアライザー

map_project を実行すると、localhost:6510 でブラウザベースのエクスプローラーが開きます：

• すべてのスクリプトとその関連性を表すフォースダイレクトグラフ

• 任意のスクリプトをクリックすると、変数、関数、シグナル、接続を確認できます

• ビジュアライザーでコードを直接編集 — 変更はGodotにリアルタイムで同期されます

• ノードプロパティ編集が可能なシーンビュー

• リファクタリング前の使用箇所の検索

制限事項

AIは単独でゲームの100%を作成することはできません。複雑なUIレイアウト、シーンの合成、一部のノードプロパティ操作が苦手です。現在も活発に開発が進められているため、フィードバックを大歓迎します！

アーキテクチャ

┌─────────────┐    MCP (stdio)   ┌──────────────┐   WebSocket   ┌──────────────┐
│  AI Client  │◄────────────────►│  MCP Server  │◄─────────────►│ Godot Editor │
│  (Claude,   │                  │  (Node.js)   │   port 6505   │  (Plugin)    │
│   Cursor)   │                  │              │               │              │
└─────────────┘                  │  Visualizer  │               │  42 tool     │
                                 │  HTTP :6510  │               │  handlers    │
                                 └──────┬───────┘               └──────────────┘
                                        │
                                 ┌──────▼───────┐
                                 │   Browser    │
                                 │  Visualizer  │
                                 └──────────────┘

現在の制限事項

• ローカルのみ — localhostで動作し、リモート接続は不可

• 単一接続 — 同時に接続できるGodotインスタンスは1つ

• 元に戻せない — 変更は直接保存されます（バージョン管理を使用してください）

• AIのGodot知識にはまだ限界がある — ゲームを単独で100%作成することはできませんが、デバッグ、スクリプト作成、そして旅のお供にはなります

開発

npmを使用せずにソースからビルドする場合：

cd mcp-server
npm install
npm run build

次に、npx の代わりにAIクライアントの設定を mcp-server/dist/index.js に向けてください。

リリースノート

各リリースの詳細な説明は release-notes/ にあります（v0.5.0 から始まります）。完全な変更履歴は CHANGELOG.md を参照してください。

ライセンス

MIT

npm package · 問題を報告