zrok-mcp

MCP-сервер для zrok — платформы для безопасного обмена данными с открытым исходным кодом, построенной на базе OpenZiti. Позволяет ИИ-агентам программно управлять туннелями, общими ресурсами и доступом zrok.

Поддерживает три транспорта: stdio (локальный), streamable-http и SSE (удаленный/Bifrost).

Инструменты

Каждый инструмент использует параметр action для выбора операции — не нужно запоминать множество названий инструментов.

zrok_env — Управление окружением

zrok_share — Управление общими ресурсами (shares)

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 перейдите в 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".

Пример использования

После настройки ваш ИИ-агент сможет выполнять такие задачи:

"Опубликуй мой локальный сервер на порту 3000 через zrok"

Агент вызовет zrok_share(action="create", target="http://localhost:3000") и вернет публичный URL.

"Покажи список всех моих общих ресурсов zrok"

Агент вызовет zrok_share(action="list") и покажет токен, режим, цель и эндпоинты.

"Создай приватный TCP-туннель для моей базы данных на порту 5432"

Агент вызовет zrok_share(action="create", share_mode="private", backend_mode="tcpTunnel", target="localhost:5432").

Лицензия

MIT