zrok-mcp

一个用于 zrok 的 MCP 服务器 —— 基于 OpenZiti 构建的开源安全共享平台。让 AI 智能体能够以编程方式管理 zrok 隧道、共享和访问。

支持 三种传输方式：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 智能体可以执行如下操作：

"Share my local server on port 3000 publicly via zrok"

智能体将调用 zrok_share(action="create", target="http://localhost:3000") 并返回公共 URL。

"List all my zrok shares"

智能体将调用 zrok_share(action="list") 并显示令牌、模式、目标和端点。

"Create a private TCP tunnel for my database on port 5432"

智能体将调用 zrok_share(action="create", share_mode="private", backend_mode="tcpTunnel", target="localhost:5432")。

许可证

MIT