Gear

👁 MCP Server
👁 Made with Godot
👁 Node.js
👁 TypeScript
👁 npm
👁 Stars
👁 MIT License

Gearを使用すると、AIアシスタントがあなたのGodotプロジェクトを直接実行、検査、修正、デバッグできるようになります。

クイックスタート (3分)

環境要件

• Godot 4.x

• Node.js 18+

• MCP対応クライアント (Claude Desktop, Cursor, Clineなど)

1) Gearの起動

npx -y gear

またはグローバルインストール：

npm install -g gear-godot-mcp
gear

2) MCPクライアントの設定

Claude Desktopなどのクライアントの設定ファイルに以下を追加します：

{
 "mcpServers": {
 "godot": {
 "command": "npx",
 "args": ["-y", "gear"],
 "env": {
 "GODOT_PATH": "/path/to/godot"
 }
 }
 }
}

3) 指示を試す

• 「/your/projects ディレクトリ内のすべてのGodotプロジェクトをリストアップして」

• 「scenes/Player.tscn を作成して、ルートノードは CharacterBody2D にして」

• 「プロジェクトを実行してデバッグ出力を取得し、エラーを修正して」

Related MCP server: godot-mcp-pilot

Gearを選ぶ理由

主な利点

利用シーン

• ✅ AIを活用して開発を加速させたい個人開発者

• ✅ AIに実際のプロジェクトやランタイムの状態を理解させたいチーム

• ✅ 高度なデバッグワークフロー (ブレークポイント、スタックトレース、ランタイム検査) を必要とする場合

ツールの使用モード

ツールの公開レベル

Gearには3つのツール公開モードがあります：

compactモードの動的ツールグループ

compact モードでは、78個の追加ツールが 22個の動的ツールグループ に整理されています：

ツールグループの使用方法

1. 自動アクティブ化 (推奨)

tool.catalog を使用して関連ツールを検索すると、一致するツールグループが自動的にアクティブ化されます

2. 手動アクティブ化

tool.groups を使用して特定のツールグループを手動でアクティブ化します 「dap ツールグループをアクティブにしてデバッグを開始して」

3. 無効化

tool.groups を使用して、アクティブ化されたグループをリセットします

インストール方法

方法 A: npx (推奨)

npx -y gear

方法 B: グローバルインストール

npm install -g gear-godot-mcp
gear

方法 C: ソースコードからインストール

git clone https://github.com/HaD0Yun/Gear-godot-mcp.git
cd Gear-godot-mcp
npm install
npm run build
node build/index.js

機能一覧

シーン編集

• シーンの作成、ノードの追加/削除

• ノードプロパティの変更

• ノードの再ペアレント

スクリプトワークフロー

• スクリプトの作成/変更

• スクリプト構造の解析

• シンボルのリネーム

ランタイムデバッグ

• ランタイムシーンツリーの検査

• ブレークポイントの設定、ステップ実行

• 変数値の確認

入力とスクリーンショット

• キーボード/マウス入力の注入

• ゲーム画面のキャプチャ

• ビューポートキャプチャ

アセット管理

• CC0素材の検索 (Poly Haven, AmbientCG, Kenney)

• プロジェクトへのリソースダウンロード

環境変数

よくある質問

関連リンク

• アーキテクチャドキュメント

• 開発ロードマップ

• 更新履歴

• 貢献ガイド

ライセンス

MIT — 詳細は LICENSE を参照してください。

謝辞

• オリジナルのMCPサーバーは Coding-Solo によるものです

• Gearの拡張機能は HaD0Yun によって開発されました

• プロジェクトの可視化機能は tomyud1/godot-mcp に触発されています

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• class-infoA
• class-queryA
• dap-outputB
• editor-debug-outputA
• editor-launchA
• editor-runA
• editor-statusA
• editor-stopA