zrok-mcp

Un servidor MCP para zrok, la plataforma de intercambio seguro de código abierto construida sobre OpenZiti. Permite a los agentes de IA gestionar túneles, recursos compartidos y accesos de zrok mediante programación.

Admite tres transportes: stdio (local), streamable-http y SSE (remoto/Bifrost).

Herramientas

Cada herramienta utiliza un parámetro action para seleccionar la operación; no es necesario recordar muchos nombres de herramientas.

zrok_env — Gestión del entorno

zrok_share — Gestión de recursos compartidos

zrok_access — Gestión de acceso

Related MCP server: env0

Requisitos

• Python 3.10+

• zrok2 SDK de Python

• Una cuenta de zrok y un entorno habilitado

Instalación

cd zrok-mcp
pip install -e .

Ejecución

El transporte se selecciona a través de la variable de entorno ZROK_MCP_TRANSPORT (predeterminado: stdio).

STDIO (predeterminado)

zrok-mcp

Streamable HTTP (remoto)

ZROK_MCP_TRANSPORT=streamable-http ZROK_MCP_PORT=8000 zrok-mcp

Docker (remoto)

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

Con MCP Inspector

mcp dev src/zrok_mcp/server.py

Variables de entorno

Configuración

Claude Desktop (stdio)

Añadir a ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Cursor / Crush (stdio)

Añadir a la configuración de crush o a la configuración de MCP:

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

Bifrost AI Gateway (streamable-http)

1. Despliegue zrok-mcp como un servidor HTTP remoto (Docker, Railway, etc.)

2. En la interfaz web de Bifrost, vaya a MCP Gateway → New MCP Server

3. Seleccione HTTP como tipo de conexión

4. Introduzca la URL: http://your-zrok-mcp-host:8000/mcp

5. Establezca tools_to_execute en ["*"] (o filtre según sea necesario)

O a través del archivo de configuración:

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

Para el transporte SSE, utilice connection_type: "sse" y connection_string: "http://your-zrok-mcp-host:8000/sse".

Ejemplo de uso

Una vez configurado, su agente de IA puede hacer cosas como:

"Comparte mi servidor local en el puerto 3000 públicamente a través de zrok"

El agente llamará a zrok_share(action="create", target="http://localhost:3000") y devolverá la URL pública.

"Lista todos mis recursos compartidos de zrok"

El agente llamará a zrok_share(action="list") y mostrará el token, el modo, el destino y los puntos finales.

"Crea un túnel TCP privado para mi base de datos en el puerto 5432"

El agente llamará a zrok_share(action="create", share_mode="private", backend_mode="tcpTunnel", target="localhost:5432").

Licencia

MIT