railway-sandbox-mcp

ChatGPT가 Railway Sandboxes를 격리된 개발/실행 환경으로 구동할 수 있게 해주는 작은 MCP 브리지입니다.

아키텍처

두 장기 실행 Railway 서비스는 모두 Railway의 GitHub 통합을 통해 이 GitHub 리포지토리에서 배포됩니다:

tunnel-client Dockerfile은 공식 ghcr.io/openai/tunnel-client:latest 이미지를 상속하며, 업스트림 health/readiness 서버가 Railway가 주입하는 PORT에 바인딩되도록 entrypoint만 래핑합니다. 배포 수명 주기는 Railway가 소유하고 OpenAI는 업스트림 이미지 제공자로 남습니다.

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 Internet

어느 Railway 서비스도 공용 도메인이 필요하지 않습니다.

Related MCP server: Railway MCP Server

코드형 구성

배포 동작은 이 리포지토리에 커밋됩니다:

• /railway.json은 MCP 서비스 빌더, watch 경로, 시작 명령, health check, 재시작 정책을 정의합니다.

• /tunnel-client/railway.json은 tunnel-client Docker 빌드, watch 경로, readiness check, 재시작 정책을 정의합니다.

• /tunnel-client/Dockerfile은 공식 OpenAI tunnel-client 이미지를 선택하고 health 리스너를 Railway가 주입하는 PORT에 맞게 조정합니다.

• /.github/workflows/ci.yml은 push와 pull request 시 Node 서비스와 Railway 구성 파일을 검증하고 tunnel-client 이미지를 빌드합니다.

코드에 커밋된 Railway 구성은 각 배포에 대해 대시보드의 동일한 빌드/배포 값을 재정의합니다.

Railway 서비스 1회성 연결 설정

소스 연결, 트리거 브랜치, 사용자 지정 구성 파일 경로는 railway.json 내부의 필드가 아닌 Railway 서비스 메타데이터이므로 Railway에서 한 번만 구성하면 됩니다:

sandbox-mcp

• 소스 리포지토리: erwinkn/railway-sandbox-mcp

• 브랜치: main

• 루트 디렉터리: /

• 구성 파일 경로: /railway.json

• GitHub 자동 배포: 활성화

• CI 대기: 활성화

tunnel-client

• 소스 리포지토리: erwinkn/railway-sandbox-mcp

• 브랜치: main

• 루트 디렉터리: /tunnel-client

• 구성 파일 경로: /tunnel-client/railway.json

• GitHub 자동 배포: 활성화

• CI 대기: 활성화

• 사용자 지정 시작 명령 없음; 리포지토리 Dockerfile entrypoint 상속

서비스별 watch 경로 덕분에 MCP 전용 변경은 tunnel client를 다시 빌드하지 않고, tunnel 전용 변경은 MCP 서버를 다시 빌드하지 않습니다.

필수 환경 변수

sandbox-mcp

• RAILWAY_API_TOKEN: Sandboxes가 활성화된 환경에 액세스할 수 있는 Railway API 토큰.

• RAILWAY_ENVIRONMENT_ID: Railway가 자동으로 주입합니다.

tunnel-client

• MCP_SERVER_URL=http://sandbox-mcp.railway.internal:8080/mcp

• CONTROL_PLANE_TUNNEL_ID=tunnel_...

• CONTROL_PLANE_API_KEY=...: Tunnel Read + Use 권한이 있는 제한된 OpenAI 런타임 키.

• LOG_LEVEL=info

• LOG_FORMAT=json

tunnel-client는 Railway가 주입하는 포트에서 /healthz, /readyz, /metrics를 노출합니다. Railway는 /readyz를 배포 health check로 사용하므로, tunnel-client 배포가 성공하면 터널 시작과 다운스트림 MCP 준비 상태가 모두 검증됩니다.

배포 흐름

main으로의 push는 GitHub Actions를 실행합니다. Railway의 Wait for CI가 활성화된 상태에서는 Railway가 CI 통과를 기다린 후, 변경된 파일과 watch 패턴이 일치하는 서비스만 자동 배포합니다.

MCP 도구

• sandbox_create

• sandbox_list

• sandbox_get

• sandbox_exec

• sandbox_read_file

• sandbox_list_files

• sandbox_write_file

• sandbox_write_files

• sandbox_checkpoint

• sandbox_destroy