yurineko73/godot-mcp-native

Developer tools

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

868 stars 75 forks 品質 79 トレンド 27MIT

Repository Install

yurineko73/godot-mcp-native は、https://github.com/yurineko73/godot-mcp-native. からインポートされたMCPサーバー候補です。

概要

yurineko73/godot-mcp-native は、https://github.com/yurineko73/godot-mcp-native. からインポートされたMCPサーバー候補です。

概要（AI 翻訳）

中文版本

Model Context Protocol(MCP)を通じてAIアシスタント(Claudeなど)を統合する強力なGodotエンジンプラグインです。AIが自然言語を通じてGodotのプロジェクト—シーン、スクリプト、ノード、リソース—を直接読み取り、修正できるようにします。

🚀 特徴

プロジェクト全アクセス:AIアシスタントはスクリプト、シーン、ノード、リソースを読み取り、修正できます
ネイティブ実装:Node.js依存関係不要 - 完全にGodot内で動作
リアルタイム編集:AIの提案を直接エディターに適用
包括的なツールセット(155ツール — 30コア+125サブ):
ノードツール(9コア+11アドバンス):シーンノードの作成、修正、管理、複製、移動、名前変更、信号接続、アンカープリセット、グループ管理、バッチ操作、シーン監査
スクリプトツール(7コア+8アドバンスド):GDScriptおよびC#ファイルの編集、分析、作成、添付、検証、スクリプト実行、ファイル検索、シンボルインデックス作成、定義および参照検索
シーンツール(4コア+4アドバンス):シーン構造の操作、シーンの保存、シーンタブのリスト/オープン/クローズ、プロジェクトシーンリスト

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

README

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

Godot MCP Native (Model Context Protocol)

中文版本

A powerful Godot Engine plugin that integrates AI assistants (Claude, etc.) via the Model Context Protocol (MCP). Enable AI to directly read and modify your Godot projects - scenes, scripts, nodes, and resources - all through natural language.

🚀 Features

Full Project Access: AI assistants can read and modify scripts, scenes, nodes, and resources
Native Implementation: No Node.js dependency required - runs entirely within Godot
Real-time Editing: Apply AI suggestions directly in the editor
Comprehensive Tool Set (155 tools — 30 core + 125 supplementary):
- Node Tools (9 core + 11 advanced): Create, modify, manage scene nodes, duplicate, move, rename, signal connections, anchor presets, group management, batch operations, scene auditing
- Script Tools (7 core + 8 advanced): Edit, analyze, create, attach, validate GDScript and C# files, execute scripts, search in files, symbol indexing, definition & reference lookup
- Scene Tools (4 core + 4 advanced): Manipulate scene structure, save scenes, list/open/close scene tabs, project scene listing
- Editor Tools (4 core + 12 advanced): Control editor functionality, screenshot, signal inspection, filesystem reload, node/file selection, export management, property inspector
- Debug Tools (3 core + 68 advanced): Logging, debugger sessions, breakpoints, stack/variable inspection, profilers, runtime probe, animation/audio/shader/tilemap runtime control, debug execution control, await_scene_ready
- Project Tools (3 core + 23 advanced): Access project settings, list resources, create resources, run tests, manage input mappings, inspect autoloads/global classes, resource diagnostics & health audit

🖥️ gdmcp CLI (Agent-First Interface)

For coding agents (Codex, Claude Code, Cursor) that have shell access, the gdmcp CLI is the recommended way to interact with Godot MCP. Instead of loading all 155 tool schemas into model context, the CLI uses progressive discovery — ~33 domain commands for common operations, and on-demand schema retrieval for supplementary tools.

# Quick start
gdmcp --json doctor
gdmcp --json scenes tree --depth 4
gdmcp --json scripts read res://player.gd --lines 1:200
gdmcp --json nodes properties set /root/Player --property speed --value 300

Installation: Open the Godot editor → MCP dock → CLI Tools tab, or download from GitHub Releases.

GitHub で README 全文を見る

インストール

npx mcp-remote http://localhost:9080/mcp

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:9080/mcp"
      ]
    }
  }
}