YG

yurineko73/godot-mcp-native

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

863 stars 75 forks Качество 83 Тренд 30MIT

yurineko73/godot-mcp-native — это кандидат на MCP-сервер, импортированный из https://github.com/yurineko73/godot-mcp-native.

Обзор

yurineko73/godot-mcp-native — это кандидат на MCP-сервер, импортированный из https://github.com/yurineko73/godot-mcp-native.

Обзор (машинный перевод)

中文版本

Мощный плагин для Godot Engine, который интегрирует AI-ассистентов (Claude и др.) через протокол Model Context Protocol (MCP). Дайте ИИ возможность напрямую читать и изменять ваши проекты Godot — сцены, скрипты, узлы и ресурсы — через естественный язык.

🚀 Особенности

  • Полный доступ к проекту: ИИ-ассистенты могут читать и изменять скрипты, сцены, узлы и ресурсы
  • Нативная реализация: Не требуется Node.js зависимости — работает полностью внутри Godot
  • Редактирование в реальном времени: Применяйте предложения ИИ непосредственно в редакторе
  • Комплексный набор инструментов (155 инструментов — 30 основных + 125 дополнительных):
  • Node Tools (9 ядер + 11 продвинутых): Создание, модификация, управление узлами сцены, дублирование, перемещение, переименование, соединения сигналов, пресеты якорей, управление группами, пакетные операции, аудит сцены
  • Инструменты скриптов (7 ядер + 8 продвинутых): редактирование, анализ, создание, прикрепление, проверка файлов GDScript и C#, выполнение скриптов, поиск в файлах, индексация символов, определение и поиск по ссылкам
  • Инструменты сцены (4 ядра + 4 продвинутых): Манипулирование структурой сцены, сохранение сцен, перечисление/открытие/закрытие вкладок сцен, список проектных сцен

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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.

Открыть полный README на GitHub

Установка

npx mcp-remote http://localhost:9080/mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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