Potassium MCP

Un puente MCP local entre aplicaciones de IA y el cliente Potassium de Roblox.

Inspección acotada por defecto. Administración de confianza solo cuando la habilitas explícitamente.

Instalar · Primera conexión · Seguridad · Solución de problemas · Configuración avanzada

Potassium MCP permite que una aplicación de IA de escritorio o CLI compatible inspeccione un cliente Potassium conectado a través de MCP estándar. Se ejecuta localmente, preserva la configuración del host no relacionada y no requiere una clave API de Anthropic, OpenAI, Google ni de ningún otro proveedor.

¿Por qué usarlo?

Related MCP server: XenozMCP

Requisitos

• Windows x64

• Potassium conectado al cliente de Roblox

• Un host de escritorio o CLI compatible con MCP

• Node.js 22 o más reciente solo cuando se usa la ruta de instalación npm

Adaptadores de host compatibles: Codex, Claude Code, Claude Desktop, VS Code, Cursor y Gemini. Otros clientes MCP pueden usar la ruta de configuración manual. Un cliente de IA solo de navegador no puede iniciar el proceso MCP local por sí mismo.

Instalar

Aplicación de configuración para Windows — recomendada

Descarga potassium-mcp-0.9.0-beta.2-Setup.exe desde el prerelease actual de GitHub. El ejecutable incluye su entorno de ejecución requerido.

1. Abre el instalador.

2. Selecciona la aplicación de IA que usas.

3. Mantén seleccionado Configuración estándar (recomendada).

4. Elige Instalar.

5. Reinicia la aplicación de IA seleccionada.

El instalador solo modifica la entrada de Potassium MCP que posee y preserva la configuración no relacionada.

npm

Instala la versión publicada más reciente:

npx --yes @mrketa/potassium-mcp setup

Para una instalación reproducible, fija la versión exacta:

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

Para selección de host no interactiva, reparación, verificación, control del broker y comandos de desinstalación, consulta Configuración avanzada.

Primera conexión

Después de la instalación y el reinicio del host, pide a la aplicación de IA que llame a:

1. potassium_status

2. potassium_capabilities

Un resultado saludable informa un cliente Potassium conectado y sus métodos compatibles del Protocolo 2. La Verificación en vivo del instalador realiza la misma inicialización MCP real y llamadas de capacidades. No consideres la instalación como completa cuando solo pasan las comprobaciones estáticas de Doctor.

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

Seguridad

Modo estándar

El modo estándar expone herramientas acotadas de inspección y diagnóstico. No proporciona acceso amplio a archivos, acceso a código fuente, acceso arbitrario a la red, control de entrada ni control remoto. HTTP transmisible es opcional, solo loopback y autenticado.

La ejecución administrativa está deshabilitada por defecto. Nunca la habilites solo porque un prompt de IA te lo pida.

Ejecución administrativa de confianza

Modo de alta confianza: habilitar esto expone potassium_execute_luau. Un host MCP local de confianza puede entonces ejecutar Luau sin restricciones en el cliente Potassium conectado y cambiar el estado del juego.

Habilítalo solo en una máquina que controles y solo cuando cada host MCP local configurado sea de confianza.

Usando la aplicación de configuración para Windows

1. Selecciona la aplicación de IA configurada.

2. Selecciona Avanzado: permitir acciones administrativas locales de confianza.

3. Confirma Entiendo que esto puede permitir que herramientas locales de confianza hagan cambios.

4. Elige Instalar para una nueva configuración o Reparar para una existente.

5. Reinicia la aplicación de IA seleccionada.

6. Confirma que potassium_capabilities reporta execute_luau.

Usando npm

Agrega --allow-unsafe-execute a una instalación o reparación explícita:

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

Reemplaza codex con el host que configuraste.

Deshabilitarlo de nuevo

• En el instalador, selecciona Configuración estándar (recomendada) y elige Reparar.

• O ejecuta el mismo comando de reparación CLI sin --allow-unsafe-execute.

• Reinicia la aplicación de IA afectada después.

Consulta Ejecución administrativa para el modelo operativo completo.

Solución de problemas

Desinstalar

Abre el instalador, selecciona la aplicación de IA configurada y elige Desinstalar. Esto elimina solo la entrada de Potassium MCP que posee y deja intacta la configuración del host no relacionada.

Para eliminación selectiva CLI o eliminación completa de todos los hosts poseídos, consulta Reparar y desinstalar.

Documentación

Licencia

Licenciado bajo la Licencia Apache 2.0.