Potassium MCP

一个本地MCP桥接，连接AI应用与Potassium Roblox客户端。

默认受限检查。仅当您明确启用时，才允许受信任的管理操作。

安装 · 首次连接 · 安全性 · 故障排除 · 高级设置

Potassium MCP 让兼容的桌面或CLI AI应用通过标准MCP检查已连接的Potassium客户端。它本地运行，保留无关的主机配置，并且不需要Anthropic、OpenAI、Google或其他提供商的API密钥。

为什么使用它？

Related MCP server: XenozMCP

要求

• Windows x64

• Potassium已连接到Roblox客户端

• 支持MCP的桌面或CLI主机

• 仅在使用npm安装路径时需要Node.js 22或更高版本

支持的主机适配器：Codex、Claude Code、Claude Desktop、VS Code、Cursor和Gemini。其他MCP客户端可以使用手动配置路径。仅浏览器的AI客户端无法自行启动本地MCP进程。

安装

Windows安装程序 — 推荐

从当前GitHub预发布版本下载potassium-mcp-0.9.0-beta.2-Setup.exe。该可执行文件包含其所需的运行时。

1. 打开安装程序。

2. 选择您使用的AI应用。

3. 保持选中标准设置（推荐）。

4. 选择安装。

5. 重启所选AI应用。

安装程序仅更改其拥有的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方法。安装程序的实时验证执行相同的真实MCP初始化和能力调用。当仅静态诊断检查通过时，不要认为安装已完成。

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

安全性

标准模式

标准模式暴露受限的检查和诊断工具。它不提供广泛的文件访问、源代码访问、任意网络访问、输入控制或远程控制。流式HTTP是可选的、仅回环且经过身份验证的。

管理执行默认禁用。切勿仅因为AI提示要求而启用它。

受信任的管理执行

高信任模式： 启用此模式会暴露potassium_execute_luau。受信任的本地MCP主机随后可以在已连接的Potassium客户端中执行不受限制的Luau并更改游戏状态。

仅当在您控制的机器上，并且每个配置的本地MCP主机都受信任时，才启用它。

使用Windows安装程序

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替换为您配置的主机。

再次禁用它

• 在安装程序中，选择标准设置（推荐）并选择修复。

• 或者运行相同的CLI修复命令，但不带--allow-unsafe-execute。

• 之后重启受影响的AI应用。

有关完整操作模型，请参阅管理执行。

故障排除

卸载

打开安装程序，选择已配置的AI应用，然后选择卸载。这仅移除拥有的Potassium MCP条目，并保留无关的主机设置。

有关选择性CLI移除或完全移除所有拥有的主机，请参阅修复和卸载。

文档

许可证

根据Apache许可证2.0许可。