Potassium MCP

Локальный мост MCP между AI-приложениями и клиентом Potassium Roblox.

По умолчанию — ограниченный просмотр. Доверенное администрирование только при явном включении.

Установка · Первое подключение · Безопасность · Устранение неполадок · Расширенная настройка

Potassium MCP позволяет совместимому настольному или CLI-приложению ИИ просматривать подключённый клиент Potassium через стандартный MCP. Он работает локально, не затрагивает постороннюю конфигурацию хоста и не требует ключа API от Anthropic, OpenAI, Google или другого провайдера.

Зачем это нужно?

Related MCP server: XenozMCP

Требования

• Windows x64

• Potassium, подключённый к клиенту Roblox

• MCP-совместимый настольный или CLI-хост

• Node.js 22 или новее — только при установке через npm

Поддерживаемые адаптеры хостов: Codex, Claude Code, Claude Desktop, VS Code, Cursor и Gemini. Другие MCP-клиенты могут использовать путь ручной настройки. AI-клиент, работающий только в браузере, не может запустить локальный MCP-процесс самостоятельно.

Установка

Приложение Setup для Windows — рекомендуется

Скачайте potassium-mcp-0.9.0-beta.2-Setup.exe из текущего предварительного релиза на GitHub. Исполняемый файл включает необходимую среду выполнения.

1. Откройте Setup.

2. Выберите используемое вами AI-приложение.

3. Оставьте выбранным Standard setup (recommended).

4. Нажмите Install.

5. Перезапустите выбранное AI-приложение.

Setup изменяет только запись Potassium MCP, которой владеет, и не затрагивает посторонние настройки.

npm

Установите последнюю опубликованную версию:

npx --yes @mrketa/potassium-mcp setup

Для воспроизводимой установки укажите точную версию:

npx --yes @mrketa/potassium-mcp@0.9.0-beta.2 setup

Команды для неинтерактивного выбора хоста, восстановления, проверки, управления брокером и удаления см. в Расширенной настройке.

Первое подключение

После установки и перезапуска хоста попросите AI-приложение вызвать:

1. potassium_status

2. potassium_capabilities

Успешный результат сообщает о подключённом клиенте Potassium и поддерживаемых им методах Protocol 2. Live verify в Setup выполняет ту же реальную инициализацию MCP и вызовы возможностей. Не считайте установку завершённой, если прошли только статические проверки Doctor.

MCP host
   │  stdio or authenticated loopback HTTP
   ▼
Potassium MCP proxy ── authenticated local broker
   │  Protocol 2 WebSocket
   ▼
Potassium client

Безопасность

Стандартный режим

Стандартный режим предоставляет ограниченные средства просмотра и диагностики. Он не даёт широкого доступа к файлам, исходному коду, произвольного сетевого доступа, управления вводом или удалённого управления. Streamable HTTP опционален, работает только через loopback и аутентифицирован.

Административное выполнение отключено по умолчанию. Никогда не включайте его только потому, что так просит AI-подсказка.

Доверенное административное выполнение

Режим высокого доверия: его включение открывает potassium_execute_luau. Доверенный локальный MCP-хост сможет выполнять неограниченный Luau в подключённом клиенте Potassium и изменять состояние игры.

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

Использование приложения Setup для Windows

1. Выберите настроенное AI-приложение.

2. Выберите Advanced: allow trusted local admin actions.

3. Подтвердите I understand this can let trusted local tools make changes.

4. Нажмите Install для новой установки или Repair для существующей.

5. Перезапустите выбранное AI-приложение.

6. Убедитесь, что potassium_capabilities сообщает execute_luau.

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

Добавьте --allow-unsafe-execute к явной установке или восстановлению:

npx --yes @mrketa/potassium-mcp@0.9.0-beta.2 repair --host codex --allow-unsafe-execute

Замените codex на настроенный вами хост.

Повторное отключение

• В Setup выберите Standard setup (recommended) и нажмите Repair.

• Или выполните ту же команду восстановления из CLI без --allow-unsafe-execute.

• После этого перезапустите затронутое AI-приложение.

Полную модель работы см. в Административном выполнении.

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

Удаление

Откройте Setup, выберите настроенное AI-приложение и нажмите Uninstall. Будет удалена только принадлежащая запись Potassium MCP, остальные настройки хоста останутся нетронутыми.

Для выборочного удаления через CLI или полного удаления всех принадлежащих хостов см. Восстановление и удаление.

Документация

Лицензия

Лицензировано на условиях Apache License 2.0.