Potassium MCP

AI 애플리케이션과 Potassium Roblox 클라이언트 간의 로컬 MCP 브리지입니다.

기본적으로 제한된 검사. 명시적으로 활성화한 경우에만 신뢰할 수 있는 관리.

설치 · 첫 연결 · 안전 · 문제 해결 · 고급 설정

Potassium MCP는 호환되는 데스크톱 또는 CLI AI 애플리케이션이 표준 MCP를 통해 연결된 Potassium 클라이언트를 검사할 수 있도록 합니다. 로컬에서 실행되며, 관련 없는 호스트 구성을 유지하고, Anthropic, OpenAI, Google 또는 다른 제공업체의 API 키가 필요하지 않습니다.

사용 이유

Related MCP server: XenozMCP

요구 사항

• Windows x64

• Roblox 클라이언트에 연결된 Potassium

• MCP를 지원하는 데스크톱 또는 CLI 호스트

• npm 설치 경로를 사용하는 경우에만 Node.js 22 이상

지원되는 호스트 어댑터: Codex, Claude Code, Claude Desktop, VS Code, Cursor, Gemini. 다른 MCP 클라이언트는 수동 구성 경로를 사용할 수 있습니다. 브라우저 전용 AI 클라이언트는 자체적으로 로컬 MCP 프로세스를 시작할 수 없습니다.

설치

Windows Setup 앱 — 권장

현재 GitHub 프리릴리스에서 potassium-mcp-0.9.0-beta.2-Setup.exe를 다운로드합니다. 실행 파일에는 필요한 런타임이 포함되어 있습니다.

1. Setup을 엽니다.

2. 사용하는 AI 애플리케이션을 선택합니다.

3. 표준 설정 (권장) 을 선택된 상태로 유지합니다.

4. 설치를 선택합니다.

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 메서드를 보고합니다. Setup의 Live verify는 동일한 실제 MCP 초기화 및 기능 호출을 수행합니다. 정적 Doctor 검사만 통과한 경우 설치를 완료된 것으로 간주하지 마십시오.

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

안전

표준 모드

표준 모드는 제한된 검사 및 진단 도구를 제공합니다. 광범위한 파일 액세스, 소스 액세스, 임의 네트워크 액세스, 입력 제어 또는 원격 제어를 제공하지 않습니다. Streamable HTTP는 선택 사항이며, 루프백 전용이고 인증됩니다.

관리 실행은 기본적으로 비활성화되어 있습니다. AI 프롬프트가 요청한다는 이유만으로 절대 활성화하지 마십시오.

신뢰할 수 있는 관리 실행

고신뢰 모드: 활성화하면 potassium_execute_luau가 노출됩니다. 신뢰할 수 있는 로컬 MCP 호스트는 연결된 Potassium 클라이언트에서 제한 없는 Luau를 실행하고 게임 상태를 변경할 수 있습니다.

당신이 제어하는 머신에서만, 그리고 구성된 모든 로컬 MCP 호스트가 신뢰할 수 있는 경우에만 활성화하십시오.

Windows Setup 앱 사용

1. 구성된 AI 애플리케이션을 선택합니다.

2. 고급: 신뢰할 수 있는 로컬 관리자 작업 허용을 선택합니다.

3. 이 기능을 활성화하면 신뢰할 수 있는 로컬 도구가 변경을 수행할 수 있음을 이해합니다를 확인합니다.

4. 새 설정의 경우 설치, 기존 설정의 경우 복구를 선택합니다.

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에서 표준 설정 (권장) 을 선택하고 복구를 선택합니다.

• 또는 --allow-unsafe-execute 없이 동일한 CLI 복구 명령을 실행합니다.

• 그 후 영향을 받은 AI 애플리케이션을 다시 시작합니다.

전체 운영 모델은 관리 실행을 참조하십시오.

문제 해결

제거

Setup을 열고 구성된 AI 애플리케이션을 선택한 다음 제거를 선택합니다. 이는 소유한 Potassium MCP 항목만 제거하며 관련 없는 호스트 설정은 그대로 유지합니다.

선택적 CLI 제거 또는 모든 소유 호스트의 전체 제거에 대해서는 복구 및 제거를 참조하십시오.

문서

라이선스

Apache License 2.0에 따라 라이선스가 부여됩니다.