Potassium MCP

Eine lokale MCP-Brücke zwischen KI-Anwendungen und dem Potassium-Roblox-Client.

Standardmäßig eingeschränkte Überprüfung. Vertrauenswürdige Verwaltung nur, wenn Sie sie explizit aktivieren.

Installation · Erstverbindung · Sicherheit · Fehlerbehebung · Erweiterte Einrichtung

Potassium MCP ermöglicht einer kompatiblen Desktop- oder CLI-KI-Anwendung die Überprüfung eines verbundenen Potassium-Clients über standardmäßiges MCP. Es läuft lokal, bewahrt die nicht zugehörige Host-Konfiguration und benötigt keinen API-Schlüssel von Anthropic, OpenAI, Google oder einem anderen Anbieter.

Warum es verwenden?

Related MCP server: XenozMCP

Voraussetzungen

• Windows x64

• Potassium, das mit dem Roblox-Client verbunden ist

• Ein MCP-fähiger Desktop- oder CLI-Host

• Node.js 22 oder neuer nur bei Verwendung des npm-Installationspfads

Unterstützte Host-Adapter: Codex, Claude Code, Claude Desktop, VS Code, Cursor und Gemini. Andere MCP-Clients können den manuellen Konfigurationspfad verwenden. Ein reiner Browser-KI-Client kann den lokalen MCP-Prozess nicht selbst starten.

Installation

Windows Setup-App — empfohlen

Laden Sie potassium-mcp-0.9.0-beta.2-Setup.exe von der aktuellen GitHub-Prerelease herunter. Die ausführbare Datei enthält die erforderliche Laufzeitumgebung.

1. Öffnen Sie Setup.

2. Wählen Sie die von Ihnen verwendete KI-Anwendung aus.

3. Belassen Sie Standardeinrichtung (empfohlen) ausgewählt.

4. Wählen Sie Installieren.

5. Starten Sie die ausgewählte KI-Anwendung neu.

Setup ändert nur den von ihm verwalteten Potassium MCP-Eintrag und bewahrt nicht zugehörige Einstellungen.

npm

Installieren Sie die neueste veröffentlichte Version:

npx --yes @mrketa/potassium-mcp setup

Für eine reproduzierbare Installation fixieren Sie die genaue Version:

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

Für nicht-interaktive Host-Auswahl, Reparatur, Verifizierung, Broker-Steuerung und Deinstallationsbefehle siehe Erweiterte Einrichtung.

Erstverbindung

Bitten Sie die KI-Anwendung nach der Installation und dem Neustart des Hosts, Folgendes aufzurufen:

1. potassium_status

2. potassium_capabilities

Ein gesundes Ergebnis meldet einen verbundenen Potassium-Client und seine unterstützten Protocol 2-Methoden. Die Live-Verifizierung des Setups führt dieselbe echte MCP-Initialisierung und Fähigkeitsabfragen durch. Behandeln Sie die Installation nicht als abgeschlossen, wenn nur statische Doctor-Prüfungen bestanden werden.

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

Sicherheit

Standardmodus

Der Standardmodus stellt eingeschränkte Überprüfungs- und Diagnosewerkzeuge bereit. Er bietet keinen breiten Dateizugriff, Quellcodezugriff, willkürlichen Netzwerkzugriff, Eingabesteuerung oder Fernsteuerung. Streamable HTTP ist optional, nur über Loopback und authentifiziert.

Die administrative Ausführung ist standardmäßig deaktiviert. Aktivieren Sie sie niemals nur, weil eine KI-Eingabeaufforderung Sie dazu auffordert.

Vertrauenswürdige administrative Ausführung

Hochvertrauensmodus: Durch Aktivierung wird potassium_execute_luau freigegeben. Ein vertrauenswürdiger lokaler MCP-Host kann dann uneingeschränktes Luau im verbundenen Potassium-Client ausführen und den Spielzustand ändern.

Aktivieren Sie ihn nur auf einem von Ihnen kontrollierten Rechner und nur, wenn jeder konfigurierte lokale MCP-Host vertrauenswürdig ist.

Verwendung der Windows Setup-App

1. Wählen Sie die konfigurierte KI-Anwendung aus.

2. Wählen Sie Erweitert: vertrauenswürdige lokale Admin-Aktionen zulassen.

3. Bestätigen Sie Ich verstehe, dass dies vertrauenswürdigen lokalen Tools erlauben kann, Änderungen vorzunehmen.

4. Wählen Sie Installieren für eine neue Einrichtung oder Reparieren für eine bestehende Einrichtung.

5. Starten Sie die ausgewählte KI-Anwendung neu.

6. Bestätigen Sie, dass potassium_capabilities execute_luau meldet.

Verwendung von npm

Fügen Sie --allow-unsafe-execute zu einer expliziten Installation oder Reparatur hinzu:

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

Ersetzen Sie codex durch den von Ihnen konfigurierten Host.

Wieder deaktivieren

• Wählen Sie im Setup Standardeinrichtung (empfohlen) und wählen Sie Reparieren.

• Oder führen Sie denselben CLI-Reparaturbefehl ohne --allow-unsafe-execute aus.

• Starten Sie die betroffene KI-Anwendung danach neu.

Siehe Administrative Ausführung für das vollständige Betriebsmodell.

Fehlerbehebung

Deinstallation

Öffnen Sie Setup, wählen Sie die konfigurierte KI-Anwendung aus und wählen Sie Deinstallieren. Dies entfernt nur den verwalteten Potassium MCP-Eintrag und lässt nicht zugehörige Host-Einstellungen intakt.

Für selektive CLI-Entfernung oder vollständige Entfernung aller verwalteten Hosts siehe Reparatur und Deinstallation.

Dokumentation

Lizenz

Lizenziert unter der Apache License 2.0.