zrok-mcp

OpenZiti上に構築されたオープンソースのセキュア共有プラットフォームzrok用のMCPサーバーです。AIエージェントがzrokのトンネル、共有、アクセスをプログラムで管理できるようにします。

3つのトランスポート（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 Web 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