DG

derfirm/godot-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

57 stars 9 forks 品質 87 トレンド 27MIT

Godotゲームエンジンとやり取りするためのモデルコンテキストプロトコル(MCP)サーバー.

概要

Godotゲームエンジンとやり取りするためのモデルコンテキストプロトコル(MCP)サーバー。 Godot MCPは、AIアシスタントがGodotエディタを起動し、プロジェクトを実行し、デバッグ出力をキャプチャし、標準化されたインターフェイスを介してプロジェクト実行を制御することを可能にします。 この直接フィードバックループは、AIアシスタントは、Godotプロジェクトで何が動作するかを理解し、より良いコード生成とデバッグ支援につながることができます。 - : 特定のプロジェクトのためにGodotエディタを開きます - : デバッグモードでGodotプロジェクトを実行します - : コンソールの出力とエラーメッセージの取得 - : 起動してプログラム的にGodotプロジェクトを中止 - : インストールされたGodotバージョンの取得 - : 指定されたディレクトリでGodotプロジェクトを検索 - : プロジェクトの構造に関する詳細情報を入手 - 指定されたルートノードタイプで新しいシーンを作成します - ノードの追加、削除、変更、および重複 - クエリノード情報とプロパティ - Sprite2Dノードにスプライトとテクスチャをロード - GridMapのMeshLibraryリソースとして3Dシーンをエクスポート - シーンを節約...

概要(AI 翻訳)

Godotゲームエンジンとやり取りするためのモデルコンテキストプロトコル(MCP)サーバー。

紹介

Godot MCPは、AIアシスタントがGodotエディタを起動し、プロジェクトを実行し、デバッグ出力をキャプチャし、標準化されたインターフェイスを介してプロジェクト実行を制御することを可能にします。

この直接フィードバックループは、AIアシスタントは、Godotプロジェクトで何が動作するかを理解し、より良いコード生成とデバッグ支援につながることができます。

流れ版: 0.1.0 Godotバージョン 必須: 4.5.0以降 ステータス: アクティブ開発

##特徴

  • Launch Godot Editor:特定のプロジェクトのためにGodotエディタを開きます -Run Godot Projects: デバッグモードでGodotプロジェクトを実行 -キャプチャデバッグ出力: コンソール出力とエラーメッセージの取得
  • 制御実行: プログラム的にGodotプロジェクトを開始し、停止
  • Godotバージョンを入手:インストールされたGodotバージョンを取得する -Godotプロジェクトをリスト:指定されたディレクトリにGodotプロジェクトを見つける -プロジェクト分析:プロジェクト構造に関する詳細情報を入手

##シーンマネジメント

  • 指定されたルートノードタイプで新しいシーンを作成する
  • ノードの追加、削除、変更、および重複
  • ノード情報とプロパティのクエリ

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Godot MCP

A Model Context Protocol (MCP) server for interacting with the Godot game engine.

Introduction

Godot MCP enables AI assistants to launch the Godot editor, run projects, capture debug output, and control project execution through a standardized interface.

This direct feedback loop helps AI assistants understand what works and what doesn’t in Godot projects, leading to better code generation and debugging assistance.

Current Version: 0.1.0
Godot Version Required: 4.5.0 or later
Status: Active Development

Features

  • Launch Godot Editor: Open the Godot editor for a specific project
  • Run Godot Projects: Execute Godot projects in debug mode
  • Capture Debug Output: Retrieve console output and error messages
  • Control Execution: Start and stop Godot projects programmatically
  • Get Godot Version: Retrieve the installed Godot version
  • List Godot Projects: Find Godot projects in a specified directory
  • Project Analysis: Get detailed information about project structure

Scene Management

  • Create new scenes with specified root node types
  • Add, remove, modify, and duplicate nodes
  • Query node information and properties
  • Load sprites and textures into Sprite2D nodes
  • Export 3D scenes as MeshLibrary resources for GridMap
  • Save scenes with options for creating variants

Script Management

  • Create GDScript files with templates (node, resource, custom)
  • Attach scripts to nodes
  • Validate script syntax with detailed error reporting
  • Get node methods and properties

Resource Management

  • Import assets with custom settings
  • Create resources (materials, shaders, etc.)
  • List project assets with metadata
  • Configure import settings

Signal System

  • Create custom signals in scripts
  • Connect signals between nodes with validation
  • List available signals on nodes
  • Disconnect signal connections

Physics System (Godot 4.5+)

  • Add physics bodies (CharacterBody2D/3D, RigidBody2D/3D, etc.)
  • Configure physics properties and materials
  • Setup collision layers and masks
  • Create Area2D/Area3D with signal connections

UI System

  • Create UI elements (Button, Label, TextEdit, Panel, etc.)
  • Apply themes to UI elements
  • Setup container layouts
  • Create menus with buttons and navigation

Animation System

  • Create AnimationPlayer nodes with animations
  • Add keyframes to animation tracks
  • Setup AnimationTree with state machines
  • Add particle systems (GPUParticles2D/3D)

Project Management

  • Update project settings
  • Configure input action mappings
  • Setup autoload singletons
  • Manage editor plugins (list, enable, disable)

Debug Module

  • Run projects with full debug output capture
  • Get error context with stack traces
  • Intelligent error analysis with solutions
  • Integration with documentation for contextual help

Documentation Module (Godot 4.5+)

  • Get detailed class information from official Godot documentation
GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "godot": { "command": "node", "args": ["/absolute/path/to/godot-mcp/build/index.js"], "env": { "DEBUG": "true" // Optional: Enable detailed logging }, "disabled": false, "autoApprove": [ "launch_editor", "run_project", "get_debug_output", "stop_project", "get_godot_version", "list_projects", "get_project_info", "create_scene", "add_node", "remove_node", "modify_node", "duplicate_node", "query_node", "load_sprite", "export_mesh_library", "save_scene", "create_script", "attach_script", "validate_script", "get_node_methods", "import_asset", "create_resource", "list_assets", "configure_import", "create_signal", "connect_signal", "list_signals", "disconnect_signal", "add_physics_body", "configure_physics", "setup_collision_layers", "create_area", "create_ui_element", "apply_theme", "setup_layout", "create_menu", "create_animation_player", "add_keyframes", "setup_animation_tree", "add_particles", "get_uid", "update_project_uids", "get_class_info", "get_method_info", "search_docs", "get_best_practices", "run_with_debug", " …