Skip to main content
Glama

DesyncedMCP

MCP-сервер для разработки модов Desynced. Предоставляет ИИ-ассистенту (Claude Code или любому MCP-клиенту) прямой доступ к справочнику Lua API игры, исходному коду базовой игры, живым журналам игры и установленным модам.

Инструменты

Статические (файловая система)

Инструмент

Назначение

search_lua_api

Поиск по официальному справочнику Lua API (включён в docs/lua-api.txt)

search_game_source

Регулярный поиск по исходникам базовой игры (main/) и модам Lua/JSON в рабочей области

get_game_logs

Чтение хвоста файла журнала игры, если он существует (см. примечание -abslog ниже)

list_mods

Список модов, которые загрузит игра, по сравнению с модами в рабочей области

read_game_file

Чтение любого файла исходников рабочей области по относительному пути с диапазоном строк

Живые (связь с отладчиком lrdb, игра запущена с -moddev)

Инструмент

Назначение

game_status

Живой снимок: тик, фракция игрока, количество сущностей, активные настройки модов

game_logs

Вывод, захваченный в реальном времени (print/errors/BOOT); переживает сбои вплоть до момента смерти

game_eval

Выполнение произвольного Lua внутри запущенной игры и возврат результата

game_reload

Debug.Reload() — горячая перезагрузка всех модов Lua, точно так же, как нажатие F7

Связь использует протокол satoren lrdb (JSON-RPC с разделителями строк, без init) на 127.0.0.1:21110. Отладочный сервер игры принимает команды от одного клиента: пока этот сервер подключён, внутриигровая консоль журнала замолкает (вывод перенаправляется на связь), и VS Code не может подключиться. Виртуальная машина отвечает на eval только во время выполнения Lua, поэтому простаивающее меню может привести к тайм-ауту.

Related MCP server: Roblox MCP Server

Мост симуляции (компаньон-мод)

game_eval выполняется в UI Lua VM игры, где мутации симуляции заблокированы. Управление игрой (перемещение, развёртывание, добыча, строительство...) требует компаньон-мода Desynced MCP Bridge в Steam Workshop, который предоставляет FactionAction.MCPSimCmd в контекст симуляции. Этот сервер работает без него для инструментов только для чтения (журналы, статус, чтение eval, горячая перезагрузка).

Настройка

npm install
npm test   # smoke test

Зарегистрируйте в Claude Code (область проекта):

claude mcp add desynced --scope project -- node <path-to>/DesyncedMCP/server.js

Конфигурация (переменные окружения)

Переменная

По умолчанию

DESYNCED_WORKSPACE

текущая рабочая директория — укажите папку с исходниками ваших модов

DESYNCED_GAME_MODS

C:/Program Files (x86)/Steam/steamapps/common/Desynced/Desynced/Content/mods — установите, если Steam находится в другом месте (пользовательская папка библиотеки)

DESYNCED_SAVED

%LOCALAPPDATA%/Desynced/Saved

Поиск по базовой игре (необязательно)

Игра поставляется со всей базовой игрой в виде main.zip внутри папки модов и всегда загружает её в сжатом виде — при обычной установке она никогда не извлекается. Чтобы search_game_source и read_game_file видели Lua базовой игры, распакуйте main.zip в папку main/ внутри вашей рабочей области с помощью любого zip-инструмента. Это чисто для удобства разработки; игре не нужна и не используется извлечённая копия.

Требования на стороне игры

Сам сервер работает вне игры — в игру ничего устанавливать не нужно. Чтобы журналы существовали, запустите Desynced с этими параметрами запуска Steam:

-moddev -log

-moddev включает режим разработчика модов (горячая перезагрузка с F7, строгие проверки данных, консоль журнала); -log записывает файл журнала, который читает этот сервер.

План развития

  • deploy_mod: копирование мода из рабочей области в папку модов игры (заменяет ручной шаг копирования)

  • Живой мост через отладочный протокол lrdb (localhost:21110 в -moddev): выполнение Lua в запущенной игре, проверка сущностей/фракций, запуск Debug.Reload()

  • Публикация в Workshop через DesyncedModUploader

Install Server
F
license - not found
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Live browser debugging for AI assistants — DOM, console, network via MCP.

  • An MCP server that gives your AI access to the source code and docs of all public github repos

  • Give your AI agent a persistent map of your project's structure, dependencies, and bugs.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/angeldeejay/DesyncedMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server