sc-bwapi-mcp

BWAPI-мост для StarCraft 1, позволяющий ИИ-ассистентам (например, Trae/Claude) управлять игрой через MCP (Model Context Protocol).

Архитектура

星际1 (1.16.1) ← BWAPI 4.4.0 注入 (Chaoslauncher)
      ↕ 共享内存 + 命名管道
bwapi_bridge.exe (C++, TCP 12345)
      ↕ JSON over TCP
sc-bwapi-mcp (Python MCP server)
      ↕ MCP stdio
Trae / Claude / 任意 MCP 客户端

Related MCP server: defcon-mcp-server

Предварительные требования

Шаги установки

1. Установка StarCraft 1 + BWAPI

1. Скачайте StarCraft Anthology (бесплатно) в клиенте Battle.net и установите в путь без пробелов, например C:\Games\Starcraft.

2. Скачайте BWAPI 4.4.0 и установите в путь без пробелов, например C:\libraries\BWAPI_440.

3. Задайте переменную окружения BWAPI_DIR = C:\libraries\BWAPI_440.

4. Скопируйте содержимое папок StarCraft\ и Windows\ из каталога установки BWAPI в каталог StarCraft.

2. Сборка библиотеки BWAPI (обязательно при первом запуске)

Файлы .lib для BWAPI 4.4.0 необходимо собрать с помощью VS2022:

$msbuild = "C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe"
$env:BWAPI_DIR = "C:\libraries\BWAPI_440"

# 编译 BWAPILIB + BWAPIClient (Release x86)
& $msbuild "$env:BWAPI_DIR\BWAPILIB\BWAPILIB.vcxproj" /p:Configuration=Release /p:Platform=Win32 /m
& $msbuild "$env:BWAPI_DIR\BWAPIClient\BWAPIClient.vcxproj" /p:Configuration=Release /p:Platform=Win32 /m

# 编译 ExampleAIModule.dll (BWAPI 4.4.0 需要一个 AI 模块才能触发 onStart)
& $msbuild "$env:BWAPI_DIR\ExampleAIModule\ExampleAIModule.vcxproj" /p:Configuration=Release /p:Platform=Win32 /p:OutDir="<星际目录>\bwapi-data\AI\" /m

3. Сборка bridge

cd <项目目录>
scripts\build_bridge.bat

Результат: cpp\build\Release\bwapi_bridge.exe

4. Настройка bwapi.ini

В каталоге StarCraft в файле bwapi-data\bwapi.ini убедитесь, что:

[ai]
ai = bwapi-data/AI/ExampleAIModule.dll
[auto_menu]
auto_menu = OFF

Использование

Порядок запуска (важно!)

1. Запустите Chaoslauncher от имени администратора → отметьте «BWAPI Injector 4.4.0 [RELEASE]» → пока не нажимайте Start.

2. Запустите bridge: scripts\run_bridge.bat (он будет ждать сервер BWAPI).

3. Нажмите Start в Chaoslauncher → войдите в StarCraft → Single Player → Expansion → Play Custom → выберите карту → начните.

4. После появления игрового экрана bridge автоматически подключится и отправит статус.

Настройка MCP-клиента

В конфигурацию MCP в Trae добавьте:

{
  "mcpServers": {
    "sc-bwapi": {
      "command": "C:\\Users\\<你>\\.local\\bin\\uv.exe",
      "args": ["run", "--directory", "<项目路径>", "sc-bwapi-mcp"]
    }
  }
}

Перезапустите Trae — инструменты станут доступны.

Инструменты MCP

Устранение неполадок

• bridge завис на «Game table mapping not found»: StarCraft не запущен, это нормальное ожидание.

• bridge не может подключиться к каналу: выйдите из игры и зайдите заново (если bridge был принудительно остановлен, флаг connected в BWAPI завис).

• build не работает: bridge использует getBuildLocation для автоматического поиска места; убедитесь, что в зоне creep есть свободное место.

• 0 FPS: конфигурация компьютера недостаточна; измените на 1v1 и в игре нажмите F5 для снижения скорости.