고급 파라미터 제어 및 런타임 튜닝

WASI 샌드박스 보안 격벽, 인메모리 퓨얼 할당 및 포트 브리지 제어 (AMV-MCP-Hub)

Release: v3.1.3 PyPI Version NPM Version WASI Engine License
핵심 가치 제안 (Why It Matters)

WASI 바이트코드 실행 중 악의적인 무한 루프나 메모리 점유를 원천 차단하고, 다중 IDE 동시 연동 시 포트 충돌 없이 안정적인 도구 중계를 보장하는 런타임 파라미터 규격입니다.

1. CLI 플래그 (npm 판)

플래그동작
--node브라우저 런타임 없이 Node 프로세스 안에서 도구를 실행합니다. MCP 클라이언트 연동 시 권장 설정입니다.
--no-open기동 시 브라우저 대시보드를 열지 않습니다. stdin이 TTY가 아니면(MCP 클라이언트) 자동으로 적용됩니다.
--port <n>HTTP/WebSocket 브리지 포트(기본 11553). 다른 프로세스가 쓰고 있으면 다음 빈 포트로 옮깁니다. 이미 실행 중인 amv-mcp-hub가 그 포트를 쓰면 그 인스턴스로 요청을 넘기는 브리지 모드로 동작합니다.
--headlesspuppeteer로 헤드리스 Chrome을 띄워 브라우저 런타임에 연결합니다. 선택 의존성 puppeteer가 필요하며 Android/Termux에서는 쓸 수 없습니다.
--status, -s / --diag, -d실행 중인 브리지의 상태 진단을 출력하고 종료합니다.

2. 환경 변수

변수기본값동작
AMV_HUB_SHELL_TIMEOUT_MS120000run_shell_command 강제 종료 시간(ms). Python 판도 같은 변수를 씁니다.
AMEVA_TOKEN자동 생성HTTP/WebSocket 인증 토큰. 없으면 게이트웨이 옆 .token(권한 0600)을 읽거나 새로 만듭니다.
AMV_HUB_INSECURE_NO_TOKEN미설정1이면 토큰 검사를 끕니다(경고 기록). 같은 기기의 다른 프로세스가 셸 명령을 실행할 수 있게 되므로 권장하지 않습니다.
AMEVA_BIND_HOST127.0.0.1브리지 바인드 주소.
AMEVA_ALLOWED_ORIGINS설정 파일 값CORS 허용 출처(쉼표 구분).
COMMAND_POLICY, ALLOWED_COMMANDS, BLOCKED_COMMANDSblocklistHTTP /exec 경로의 명령 필터. MCP 도구 run_shell_command에는 적용되지 않습니다.
AMEVA_MAX_OUTPUT_BYTES10485760HTTP /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 저장소를 지정할 수 있습니다.