AG

alexmeckes/godot-mcp

Developer tools

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

43 stars 12 forks 品質 77 トレンド 20MIT

alexmeckes/godot-mcp は [https://github.com/alexmeckes/godot-mcp.] からインポートされた MCP サーバー候補です

概要

alexmeckes/godot-mcp は [https://github.com/alexmeckes/godot-mcp.] からインポートされた MCP サーバー候補です

概要(AI 翻訳)

[godot-mcpは、AI支援Godot 4.x開発用のMCP(モデルコンテキストプロトコル)サーバーです。 .tscn, .gd]], [.gdshader]], [.tres]], [[project.godot]]で推測するのではなく、Godotプロジェクトを検査および変更するための構造化された方法を提供します。

シーン操作、スクリプト生成、シェーダー作成、アニメーションワークフロー、インプットマップのセットアップ、オーディオルーティング/プレーヤーのセットアップ、ナビゲーション設定、UI構築、手順生成、プロジェクトセットアップ、ライブエディタのコントロール、ランタイムの自動化など、13カテゴリにわたって**99ツールを説明します。

一緒に合う方法

| ピース | 役割 | お問い合わせ | [godot-mcp | 本リポジトリのMCPサーバー AIクライアントが呼び出すことができるツール表面を公開 | | [addons/godot_ai_bridge|このリポジトリにバンドルされたオプションのGodotプラグイン。 ライブエディタのコントロール、ランタイム入力自動化、スクリーンショットが必要です。 お問い合わせ | [godot-claude-skills | 任意仲間のスキルパック コード生成、シーンデザイン、シェーダー、ライブGodotワークのナレッジとワークフローレイヤーを追加します。 パーシステントエディタ/ランタイムループのための高度な[godot-interactiveスキルが含まれています。 お問い合わせ

**おすすめの仲間:**このMCPを[godot-claude-skillsでペアリングします。 [godot-mcp]]はツールを提供します.

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

README

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

Godot MCP Server

godot-mcp is an MCP (Model Context Protocol) server for AI-assisted Godot 4.x development. It gives AI clients a structured way to inspect and change Godot projects instead of guessing at .tscn, .gd, .gdshader, .tres, or project.godot formats.

It exposes 99 tools across 13 categories for scene manipulation, script generation, shader creation, animation workflows, InputMap setup, audio routing/player setup, navigation setup, UI building, procedural generation, project setup, live editor control, and runtime automation.

How It Fits Together

Piece Role
godot-mcp The MCP server in this repo. Exposes the tool surface your AI client can call.
addons/godot_ai_bridge Optional Godot plugin bundled in this repo. Required for live editor control, runtime input automation, and screenshots.
godot-claude-skills Optional companion skill pack. Adds knowledge and workflow layers for code generation, scene design, shaders, and live Godot work. Includes the advanced godot-interactive skill for persistent editor/runtime loops.

Recommended companion: Pair this MCP with godot-claude-skills. godot-mcp provides the tools. The skill pack improves how an agent uses them, especially through its godot-interactive workflow.

Features

File-Based Tools (Always Available)

  • Scene Tools: Read, write, and manipulate .tscn scene files
  • Script Tools: Generate and analyze GDScript files
  • Shader Tools: Create shaders with 11 preset effects (dissolve, outline, hologram, etc.)
  • Resource Tools: Manage .tres resource files
  • Animation Tools: Create and edit animation clips, keyframes, and scene animation setup
  • Input Tools: Manage InputMap actions/bindings and apply control presets
  • Audio Tools: Create bus layouts and configure AudioStreamPlayer nodes
  • Navigation Tools: Set up navigation regions, agents, and links in scene files
  • UI Tools: Create themes, menus, HUDs, dialogs, and responsive layouts
  • Procedural Generation: Dungeons, tilemaps, and enemy wave configurations

Live Editor Tools (Requires Godot AI Bridge Plugin)

  • Real-time scene tree inspection
  • Live node manipulation with undo/redo support
  • Run/stop scenes directly from your AI assistant
  • Capture runtime errors and console output
  • Select nodes in the editor
  • Drive the running game with synthetic actions, pointer events, and text entry
  • Capture viewport screenshots from the running game

Documentation

  • Built-in Godot 4.x class documentation
  • Searchable API reference for commonly used engine classes

Quick Start

  1. Build the MCP server from source.
  2. Point your MCP client at dist/index.js and pass --project /path/to/your/godot/project.
GitHub で README 全文を見る

インストール

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

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

設定

{ "mcpServers": { "godot-mcp": { "command": "node", "args": [ "/path/to/godot-mcp/dist/index.js", "--project", "/path/to/your/godot/project" ] } } }