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のライブ検証は、同じ実際の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の下でライセンスされています。