railway-sandbox-mcp
railway-sandbox-mcp
Un pequeño puente MCP que permite a ChatGPT controlar Railway Sandboxes como un entorno de desarrollo/ejecución aislado.
Arquitectura
Ambos servicios Railway de larga duración se despliegan desde este repositorio de GitHub mediante la integración de GitHub de Railway:
Servicio Railway | Rama de GitHub | Directorio raíz de Railway | Archivo de configuración como código | Propósito |
|
|
|
| Servidor MCP Node respaldado por el SDK de Railway Sandbox |
|
|
|
| Cliente de túnel MCP seguro de OpenAI |
El Dockerfile de tunnel-client hereda la imagen oficial ghcr.io/openai/tunnel-client:latest y solo envuelve su punto de entrada para que el servidor de salud/disponibilidad ascendente se vincule al PORT inyectado por Railway. Railway posee el ciclo de vida del despliegue mientras que OpenAI sigue siendo el proveedor de la imagen ascendente.
ChatGPT
|
v
OpenAI Secure MCP Tunnel
^
| outbound HTTPS
|
tunnel-client (Railway)
|
| Railway private network
v
sandbox-mcp:8080/mcp (Railway)
|
v
Railway Sandbox SDK
|
v
Ephemeral isolated Linux sandboxes with outbound InternetNinguno de los servicios Railway necesita un dominio público.
Related MCP server: Railway MCP Server
Configuración como código
El comportamiento de despliegue está comprometido en este repositorio:
/railway.jsondefine el constructor del servicio MCP, rutas de observación, comando de inicio, verificación de salud y política de reinicio./tunnel-client/railway.jsondefine la compilación Docker del cliente de túnel, rutas de observación, verificación de disponibilidad y política de reinicio./tunnel-client/Dockerfileselecciona la imagen oficial del cliente de túnel de OpenAI y adapta su listener de salud alPORTinyectado por Railway./.github/workflows/ci.ymlvalida el servicio Node y los archivos de configuración de Railway y compila la imagen del cliente de túnel en pushes y pull requests.
La configuración de Railway comprometida en código anula los valores equivalentes de compilación/despliegue del panel para cada despliegue.
Configuración única del servicio Railway
La asociación de fuente, la rama de activación y la ruta personalizada del archivo de configuración son metadatos del servicio Railway, no campos dentro de railway.json, por lo que se configuran una vez en Railway:
sandbox-mcp
Repositorio de origen:
erwinkn/railway-sandbox-mcpRama:
mainDirectorio raíz:
/Ruta del archivo de configuración:
/railway.jsonAutodespliegue de GitHub: habilitado
Esperar a CI: habilitado
tunnel-client
Repositorio de origen:
erwinkn/railway-sandbox-mcpRama:
mainDirectorio raíz:
/tunnel-clientRuta del archivo de configuración:
/tunnel-client/railway.jsonAutodespliegue de GitHub: habilitado
Esperar a CI: habilitado
Sin comando de inicio personalizado; heredar el punto de entrada del Dockerfile del repositorio
Las rutas de observación específicas del servicio significan que los cambios solo de MCP no reconstruyen el cliente de túnel, y los cambios solo de túnel no reconstruyen el servidor MCP.
Variables de entorno requeridas
sandbox-mcp
RAILWAY_API_TOKEN: Token de API de Railway con acceso al entorno donde los Sandboxes están habilitados.RAILWAY_ENVIRONMENT_ID: inyectado automáticamente por Railway.
tunnel-client
MCP_SERVER_URL=http://sandbox-mcp.railway.internal:8080/mcpCONTROL_PLANE_TUNNEL_ID=tunnel_...CONTROL_PLANE_API_KEY=...: clave de runtime de OpenAI restringida con permisos de Lectura y Uso de Túnel.LOG_LEVEL=infoLOG_FORMAT=json
tunnel-client expone /healthz, /readyz y /metrics en el puerto inyectado por Railway. Railway usa /readyz como verificación de salud del despliegue, por lo que un despliegue exitoso del cliente de túnel verifica tanto el inicio del túnel como la disponibilidad del MCP descendente.
Flujo de despliegue
Un push a main ejecuta GitHub Actions. Con Esperar a CI de Railway habilitado, Railway espera a que CI pase y luego autodespliega solo los servicios cuyos patrones de observación coinciden con los archivos modificados.
Herramientas MCP
sandbox_createsandbox_listsandbox_getsandbox_execsandbox_read_filesandbox_list_filessandbox_write_filesandbox_write_filessandbox_checkpointsandbox_destroy
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Develop, manage, and debug Railway projects, services, and deployments from within agents.
Linux VMs for AI agents: create VMs, run commands, edit files and open preview URLs.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
A persistent Linux computer for your AI: what it installs and writes survives the session.
Related MCP Servers
AlicenseNot gradedqualityDmaintenanceEnables spawning ephemeral Linux sandbox containers using Docker and executing commands through an interactive TTY interface. Supports collaborative terminal sessions where both AI clients and humans can simultaneously interact with the same container.27MIT- AlicenseAqualityDmaintenanceEnables AI systems like Claude and Cursor to directly manage Railway projects, deployments, services, environment variables, and monitor logs through natural language commands.9MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to operate a persistent Linux sandbox in the cloud, running commands, managing files, using Git, and publishing artifacts through a Streamable HTTP MCP endpoint.-
- AlicenseNot gradedqualityBmaintenanceEnables ChatGPT to execute shell commands and control Docker inside isolated, disposable sandbox microVMs without exposing the host shell or Docker daemon.13 npm2MIT