Skip to main content
Glama
madonchik123

umbrella-mcp

by madonchik123
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Umbrella MCP

English

Локальный MCP-сервер для работы с Lua-скриптами Umbrella и состоянием матча. Сервер запускается через stdio, а Lua bridge устанавливается в папку scripts выбранной установки Umbrella.

Установка

Откройте PowerShell и выполните:

& ([scriptblock]::Create((Invoke-RestMethod "https://raw.githubusercontent.com/madonchik123/umbrella-mcp/main/bootstrap.ps1")))

Установщик спросит путь к Umbrella, например C:\Umbrella. Путь можно передать сразу:

& ([scriptblock]::Create((Invoke-RestMethod "https://raw.githubusercontent.com/madonchik123/umbrella-mcp/main/bootstrap.ps1"))) -UmbrellaDirectory "C:\Umbrella"

После установки перезагрузите скрипты Umbrella. Если Codex установлен, сервер уже будет добавлен в него. Для остальных клиентов используйте примеры ниже.

Локальная установка из клонированного репозитория:

install.cmd "C:\Umbrella"

Свой API reference можно передать вторым аргументом. Без него установщик скачает reference в папку сервера:

install.cmd "C:\Umbrella" "D:\UmbrellaAPI"

Related MCP server: ue-angelscript-mcp

Пути в примерах

Примеры ниже рассчитаны на установку Umbrella в C:\Umbrella. Если у вас другой путь, замените его в command и args.

command: C:\Umbrella\tools\umbrella-mcp\.venv\Scripts\python.exe
args:    C:\Umbrella\tools\umbrella-mcp\umbrella_mcp\server.py
         --config
         C:\Umbrella\tools\umbrella-mcp\umbrella_mcp\config.json

Управление из Umbrella

Установщик спросит общий токен. Нажмите Enter, чтобы сгенерировать его автоматически. После загрузки bridge откройте Scripts → Main → Umbrella MCP: там отображается статус подключения и можно указать адрес, порт и токен уже запущенного MCP-сервера.

Codex

Обычно установщик добавляет сервер сам. Для ручной установки:

codex mcp add umbrella -- "C:\Umbrella\tools\umbrella-mcp\.venv\Scripts\python.exe" "C:\Umbrella\tools\umbrella-mcp\umbrella_mcp\server.py" --config "C:\Umbrella\tools\umbrella-mcp\umbrella_mcp\config.json"
codex mcp get umbrella

Claude Code

claude mcp add --transport stdio --scope user umbrella -- "C:\Umbrella\tools\umbrella-mcp\.venv\Scripts\python.exe" "C:\Umbrella\tools\umbrella-mcp\umbrella_mcp\server.py" --config "C:\Umbrella\tools\umbrella-mcp\umbrella_mcp\config.json"
claude mcp get umbrella

Документация: Claude Code MCP.

Claude Desktop

Откройте %APPDATA%\Claude\claude_desktop_config.json и добавьте:

{
  "mcpServers": {
    "umbrella": {
      "type": "stdio",
      "command": "C:\\Umbrella\\tools\\umbrella-mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Umbrella\\tools\\umbrella-mcp\\umbrella_mcp\\server.py",
        "--config",
        "C:\\Umbrella\\tools\\umbrella-mcp\\umbrella_mcp\\config.json"
      ]
    }
  }
}

Полностью перезапустите Claude Desktop.

Cursor

Создайте %USERPROFILE%\.cursor\mcp.json для глобальной установки или .cursor\mcp.json внутри проекта:

{
  "mcpServers": {
    "umbrella": {
      "command": "C:\\Umbrella\\tools\\umbrella-mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Umbrella\\tools\\umbrella-mcp\\umbrella_mcp\\server.py",
        "--config",
        "C:\\Umbrella\\tools\\umbrella-mcp\\umbrella_mcp\\config.json"
      ]
    }
  }
}

Перезапустите Cursor и проверьте сервер в Settings → Tools & MCP. Документация: Cursor MCP.

VS Code

Выполните команду MCP: Open User Configuration или создайте .vscode\mcp.json в проекте:

{
  "servers": {
    "umbrella": {
      "type": "stdio",
      "command": "C:\\Umbrella\\tools\\umbrella-mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Umbrella\\tools\\umbrella-mcp\\umbrella_mcp\\server.py",
        "--config",
        "C:\\Umbrella\\tools\\umbrella-mcp\\umbrella_mcp\\config.json"
      ]
    }
  }
}

Запустите сервер через действие над ним в mcp.json. Документация: MCP в VS Code.

Другие MCP-клиенты

Добавьте локальный stdio-сервер с именем umbrella, используя command и args из раздела «Пути в примерах». Если клиент принимает обычный MCP JSON, используйте блок mcpServers из примера для Cursor. Для клиентов с форматом VS Code используйте блок servers.

MCP tools

runtime_status
search_api
ping_runtime
get_game_snapshot
get_inventory
inspect_entity
list_loaded_scripts
set_event_filter
get_recent_events
clear_events
read_debug_log
clear_runtime_debug_log
run_script
reload_scripts
execute_console_command
run_panorama_javascript

Проверка

После запуска клиента попросите модель вызвать runtime_status, затем ping_runtime. Если bridge не подключён, перезагрузите скрипты Umbrella и убедитесь, что загружен umbrella_mcp_bridge.lua.

Разработка

python -m pip install -r requirements.txt
python -m unittest discover -s tests -v
luau-compile --only-parse bridge\umbrella_mcp_bridge.lua

Лицензия

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers