zrok-mcp

OpenZiti 기반의 오픈 소스 보안 공유 플랫폼인 zrok을 위한 MCP 서버입니다. AI 에이전트가 zrok 터널, 공유 및 액세스를 프로그래밍 방식으로 관리할 수 있게 해줍니다.

**세 가지 전송 방식(transport)**을 지원합니다: stdio(로컬), streamable-http 및 SSE(원격/Bifrost).

도구

각 도구는 action 매개변수를 사용하여 작업을 선택하므로, 많은 도구 이름을 기억할 필요가 없습니다.

zrok_env — 환경 관리

zrok_share — 공유 관리

zrok_access — 액세스 관리

Related MCP server: env0

요구 사항

• Python 3.10+

• zrok2 Python SDK

• zrok 계정 및 활성화된 환경

설치

cd zrok-mcp
pip install -e .

실행

전송 방식은 ZROK_MCP_TRANSPORT 환경 변수를 통해 선택합니다 (기본값: stdio).

STDIO (기본값)

zrok-mcp

Streamable HTTP (원격)

ZROK_MCP_TRANSPORT=streamable-http ZROK_MCP_PORT=8000 zrok-mcp

Docker (원격)

docker build -t zrok-mcp .
docker run -p 8000:8000 -v ~/.zrok2:/root/.zrok2 zrok-mcp

MCP Inspector 사용

mcp dev src/zrok_mcp/server.py

환경 변수

구성

Claude Desktop (stdio)

~/Library/Application Support/Claude/claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "zrok": {
      "command": "uv",
      "args": ["--directory", "/path/to/zrok-mcp", "run", "zrok-mcp"]
    }
  }
}

Cursor / Crush (stdio)

Crush 설정 또는 MCP 구성에 추가하세요:

{
  "zrok": {
    "command": "uv",
    "args": ["--directory", "/path/to/zrok-mcp", "run", "zrok-mcp"]
  }
}

Bifrost AI Gateway (streamable-http)

1. zrok-mcp를 원격 HTTP 서버(Docker, Railway 등)로 배포합니다.

2. Bifrost 웹 UI에서 MCP Gateway → New MCP Server로 이동합니다.

3. 연결 유형으로 HTTP를 선택합니다.

4. URL을 입력합니다: http://your-zrok-mcp-host:8000/mcp

5. tools_to_execute를 ["*"]로 설정합니다 (또는 필요에 따라 필터링).

또는 구성 파일을 통해 설정:

{
  "mcp": {
    "mcp_clients": [
      {
        "name": "zrok",
        "connection_type": "http",
        "connection_string": "http://your-zrok-mcp-host:8000/mcp",
        "tools_to_execute": ["*"]
      }
    ]
  }
}

SSE 전송 방식의 경우 connection_type: "sse" 및 connection_string: "http://your-zrok-mcp-host:8000/sse"를 사용하세요.

사용 예시

구성이 완료되면 AI 에이전트가 다음과 같은 작업을 수행할 수 있습니다:

"zrok을 통해 내 로컬 서버 3000번 포트를 공개적으로 공유해줘"

에이전트가 zrok_share(action="create", target="http://localhost:3000")을 호출하고 공개 URL을 반환합니다.

"내 모든 zrok 공유 목록을 보여줘"

에이전트가 zrok_share(action="list")를 호출하고 토큰, 모드, 대상 및 엔드포인트를 표시합니다.

"5432번 포트의 데이터베이스를 위한 비공개 TCP 터널을 생성해줘"

에이전트가 zrok_share(action="create", share_mode="private", backend_mode="tcpTunnel", target="localhost:5432")를 호출합니다.

라이선스

MIT