zrok-mcp

Ein MCP-Server für zrok — die Open-Source-Plattform für sicheres Teilen, die auf OpenZiti basiert. Ermöglicht KI-Agenten die programmgesteuerte Verwaltung von zrok-Tunneln, Freigaben und Zugriffen.

Unterstützt drei Transporte: stdio (lokal), streamable-http und SSE (remote/Bifrost).

Tools

Jedes Tool verwendet einen action-Parameter, um den Vorgang auszuwählen — es müssen nicht viele Tool-Namen auswendig gelernt werden.

zrok_env — Umgebungsmanagement

zrok_share — Freigabemanagement

zrok_access — Zugriffsmanagement

Related MCP server: env0

Anforderungen

• Python 3.10+

• zrok2 Python SDK

• Ein zrok-Account und eine aktivierte Umgebung

Installation

cd zrok-mcp
pip install -e .

Ausführung

Der Transport wird über die Umgebungsvariable ZROK_MCP_TRANSPORT ausgewählt (Standard: stdio).

STDIO (Standard)

zrok-mcp

Streamable HTTP (remote)

ZROK_MCP_TRANSPORT=streamable-http ZROK_MCP_PORT=8000 zrok-mcp

Docker (remote)

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

Mit MCP Inspector

mcp dev src/zrok_mcp/server.py

Umgebungsvariablen

Konfiguration

Claude Desktop (stdio)

Hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Cursor / Crush (stdio)

Hinzufügen zu Ihren Crush-Einstellungen oder der MCP-Konfiguration:

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

Bifrost AI Gateway (streamable-http)

1. Stellen Sie zrok-mcp als Remote-HTTP-Server bereit (Docker, Railway, etc.)

2. Gehen Sie im Bifrost Web-UI auf MCP Gateway → New MCP Server

3. Wählen Sie HTTP als Verbindungstyp

4. Geben Sie die URL ein: http://your-zrok-mcp-host:8000/mcp

5. Setzen Sie tools_to_execute auf ["*"] (oder filtern Sie nach Bedarf)

Oder über eine Konfigurationsdatei:

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

Für SSE-Transport verwenden Sie connection_type: "sse" und connection_string: "http://your-zrok-mcp-host:8000/sse".

Beispielanwendung

Sobald die Konfiguration abgeschlossen ist, kann Ihr KI-Agent Dinge tun wie:

"Teile meinen lokalen Server auf Port 3000 öffentlich über zrok"

Der Agent ruft zrok_share(action="create", target="http://localhost:3000") auf und gibt die öffentliche URL zurück.

"Liste alle meine zrok-Freigaben auf"

Der Agent ruft zrok_share(action="list") auf und zeigt Token, Modus, Ziel und Endpunkte an.

"Erstelle einen privaten TCP-Tunnel für meine Datenbank auf Port 5432"

Der Agent ruft zrok_share(action="create", share_mode="private", backend_mode="tcpTunnel", target="localhost:5432") auf.

Lizenz

MIT