Godot MCP Gateway

English | 简体中文

Один редактор Godot — множество AI-агентов.

Godot MCP Gateway — это локальная управляющая плоскость, которая позволяет Codex, Claude Code, OpenCode, Pi и другим MCP-клиентам безопасно использовать один редактор Godot. Каждый клиент сохраняет независимый MCP-сеанс, а один общий для всей машины Gateway отвечает за обнаружение редактора, маршрутизацию запросов, планирование записи, доступ к игровым тестам, подключение к Godot LSP и переподключения.

Статус проекта: ранняя разработка. Топология Gateway v1, гетерогенное пакетное выполнение и пользовательский интерфейс активности редактора реализованы, но проект ещё не выпустил стабильную версию.

Зачем нужен Gateway?

Большинство Godot MCP-интеграций запускают один сервер и занимают один порт редактора для каждого AI-клиента. Такая модель становится ненадёжной, когда над одним проектом работают несколько агентов. Этот проект разделяет сеансы агентов и подключение к редактору:

Codex -------- stdio shim --\
Claude Code -- stdio shim ---+-- local IPC -- Gateway -- WebSocket -- Godot Editor
OpenCode ----- stdio shim ---/                   |-- Playtest Runtime
Pi ----------- stdio shim --/                    `-- Godot LSP

Плагин Godot подключается к Gateway наружу. Агенты никогда не занимают пулы портов Godot и не подключаются к редактору напрямую.

Related MCP server: agent-bus-mcp

Возможности

• Многопользовательские сеансы: каждый MCP-клиент имеет свою учётную запись, жизненный цикл и поток активности.

• Одно подключение к редактору: Gateway управляет маршрутизацией редактора, среды выполнения и LSP.

• Упорядоченная запись: изменения редактора от разных агентов планируются по принципу FIFO.

• Кросс-инструментальные пакеты: batch последовательно выполняет разнородные MCP-инструменты, останавливается при сбое и предотвращает чередование записей других агентов.

• Наглядные операции: панель Godot показывает подключённых агентов, поставленные в очередь и выполняемые задачи, ход выполнения пакетов и последние результаты.

• Фокус на редакторе: при успешном изменении можно выделить и сфокусировать затронутый узел.

• Полная база инструментов: каталог инструментов Godot из вышестоящего репозитория остаётся доступен через архитектуру Gateway.

Требования

• Godot 4.2 или новее

• Node.js 22 или новее

• npm

Запуск из исходного кода

Клонируйте и соберите репозиторий:

git clone https://github.com/di404/godot-mcp-gateway.git
cd godot-mcp-gateway
npm install
npm run build

Скопируйте addons/godot_mcp_gateway/ в каталог addons/ вашего проекта Godot, затем включите Godot MCP Gateway в Project Settings → Plugins.

Запустите общий для всей машины Gateway в терминале и оставьте его работать:

npm run start:gateway

Настройте каждого MCP-клиента на запуск собственного stdio-адаптера. Замените /absolute/path/to/godot-mcp-gateway на абсолютный путь к клонированному репозиторию:

{
  "mcpServers": {
    "godot-mcp-gateway": {
      "command": "node",
      "args": [
        "/absolute/path/to/godot-mcp-gateway/packages/server/dist/index.js",
        "stdio"
      ],
      "env": {
        "GODOT_MCP_PROJECT_PATH": "/absolute/path/to/your-godot-project"
      }
    }
  }
}

Если MCP-клиент запускается в корне проекта Godot, GODOT_MCP_PROJECT_PATH можно не указывать. Установите GODOT_MCP_AGENT_NAME, чтобы переопределить метку агента, отображаемую на панели.

Пример пакета

Инструмент batch принимает обычные зарегистрированные вызовы инструментов:

{
  "calls": [
    {
      "tool": "scene_get_tree",
      "arguments": { "max_depth": 1 }
    },
    {
      "tool": "project_get_settings",
      "arguments": { "prefix": "application/" }
    }
  ]
}

Вызовы выполняются по порядку через обычный конвейер проверки и инструментов. Выполнение останавливается на первом неудачном или отменённом шаге, а остальные шаги помечаются как skipped. Вложенные пакеты и ссылки на выходные данные не поддерживаются в v1.

Структура репозитория

• addons/godot_mcp_gateway/ — плагин редактора Godot, обработчики инструментов и панель.

• packages/server/ — процесс Gateway, поверхность stdio MCP, IPC, каталог инструментов, планировщик, маршрутизация среды выполнения и владение LSP.

• docs/ — документация по архитектуре, протоколу, вкладу, совместимости и локальному тестированию.

Корень репозитория также является небольшим проектом Godot для разработки и тестирования плагина. Начните с указателя документации для получения более подробных руководств.

Текущие ограничения v1

• Один Gateway принимает один редактор Godot и одну активную среду игрового теста.

• Gateway запускается вручную и работает в интерактивном режиме.

• Пакет останавливается при сбое, при этом каждое изменение сохраняет собственный шаг отмены.

• Вложенные пакеты и ссылки на выходные данные намеренно отложены.

Авторство и лицензия

Этот проект является активным форком Godot MCP Toolkit и Godot MCP Server от NPGameDev. Их зрелый каталог инструментов и интеграция с редактором составляют основу функциональности; этот форк меняет топологию подключения вокруг них.

Исходный код доступен по лицензии MIT. См. ATTRIBUTIONS.md для сохранённых уведомлений вышестоящего проекта и благодарностей третьим лицам. Унаследованные изображения вышестоящего проекта являются материалами для разработки и не лицензируются как независимый брендовый актив этого форка; замените их перед выпуском брендированной версии.