고급 파라미터 제어 및 런타임 튜닝
WASI 샌드박스 보안 격벽, 인메모리 퓨얼 할당 및 포트 브리지 제어 (AMV-MCP-Hub)
핵심 가치 제안 (Why It Matters)
WASI 바이트코드 실행 중 악의적인 무한 루프나 메모리 점유를 원천 차단하고, 다중 IDE 동시 연동 시 포트 충돌 없이 안정적인 도구 중계를 보장하는 런타임 파라미터 규격입니다.
1. CLI 플래그 (npm 판)
| 플래그 | 동작 |
|---|---|
--node | 브라우저 런타임 없이 Node 프로세스 안에서 도구를 실행합니다. MCP 클라이언트 연동 시 권장 설정입니다. |
--no-open | 기동 시 브라우저 대시보드를 열지 않습니다. stdin이 TTY가 아니면(MCP 클라이언트) 자동으로 적용됩니다. |
--port <n> | HTTP/WebSocket 브리지 포트(기본 11553). 다른 프로세스가 쓰고 있으면 다음 빈 포트로 옮깁니다. 이미 실행 중인 amv-mcp-hub가 그 포트를 쓰면 그 인스턴스로 요청을 넘기는 브리지 모드로 동작합니다. |
--headless | puppeteer로 헤드리스 Chrome을 띄워 브라우저 런타임에 연결합니다. 선택 의존성 puppeteer가 필요하며 Android/Termux에서는 쓸 수 없습니다. |
--status, -s / --diag, -d | 실행 중인 브리지의 상태 진단을 출력하고 종료합니다. |
2. 환경 변수
| 변수 | 기본값 | 동작 |
|---|---|---|
AMV_HUB_SHELL_TIMEOUT_MS | 120000 | run_shell_command 강제 종료 시간(ms). Python 판도 같은 변수를 씁니다. |
AMEVA_TOKEN | 자동 생성 | HTTP/WebSocket 인증 토큰. 없으면 게이트웨이 옆 .token(권한 0600)을 읽거나 새로 만듭니다. |
AMV_HUB_INSECURE_NO_TOKEN | 미설정 | 1이면 토큰 검사를 끕니다(경고 기록). 같은 기기의 다른 프로세스가 셸 명령을 실행할 수 있게 되므로 권장하지 않습니다. |
AMEVA_BIND_HOST | 127.0.0.1 | 브리지 바인드 주소. |
AMEVA_ALLOWED_ORIGINS | 설정 파일 값 | CORS 허용 출처(쉼표 구분). |
COMMAND_POLICY, ALLOWED_COMMANDS, BLOCKED_COMMANDS | blocklist | HTTP /exec 경로의 명령 필터. MCP 도구 run_shell_command에는 적용되지 않습니다. |
AMEVA_MAX_OUTPUT_BYTES | 10485760 | HTTP /exec 출력 상한. |
AMEVA_TESTER_DIR, AMV_DEF_ROOT | 미설정 | 유지보수자 전용 도구(tester_*, 게시 도구)가 사용할 로컬 체크아웃 경로. |
3. WASI 실행기 (wasm_exec)
| 항목 | 동작 |
|---|---|
| 입력 | wasm_base64(필수), args(문자열 배열), stdin(문자열 또는 JSON). |
| 런타임 | npm 판은 Node 내장 WASI preview 1 구현, Python 판은 선택 패키지 wasmtime이 설치된 경우에만 제공합니다. |
| 자원 제한 | 명령어 수(fuel), 메모리 페이지, 실행 시간에 대한 별도 상한은 없습니다. 신뢰할 수 있는 모듈만 실행하십시오. |
4. 설정 파일 (mcp.wasm.config.json)
{
"port": 11553,
"execution": { "adapter": "node" },
"git": { "adapter": "local", "localPath": null },
"repos": [],
"hotreload": { "adapter": "polling", "pollingIntervalMs": 30000 },
"disabled_tools": [],
"security": { "allowedOrigins": ["http://localhost:11553", "http://127.0.0.1:11553"] }
}
npm 패키지에 포함된 기본 설정입니다. 동적 도구는 git.localPath(기본 ./tools)의 mcp_manifest.json에서 읽고, git/repos에 GitHub·GitLab 저장소를 지정할 수 있습니다.