teztun

@asadullokhn/teztun-mcp

官方 TezTun MCP 服务，是一个可单次安装的 npm 包，适用于 Claude Desktop / Claude Code / Cursor / Zed / Windsurf / 任何 Model Context Protocol 客户端。

让你的 AI 编辑器通过聊天管理 TezTun 基础设施：

• “我当前的 webhook URL 是什么？” → list_tunnels
• “预留一个名为 demo 的子域名” → reserve_subdomain
• “为 prod-docker 创建一个永不过期的服务令牌” → create_service_token
• “撤销 staging-ci 令牌” → revoke_service_token

安装与配置

你无需手动安装——MCP 客户端会通过 npx 运行它。选择你的客户端：

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "teztun": {
      "command": "npx",
      "args": ["-y", "@asadullokhn/teztun-mcp"],
      "env": { "TEZTUN_TOKEN": "tzt_your-token-here" }
    }
  }
}

Claude Code

claude mcp add --scope user teztun \
  -e TEZTUN_TOKEN=tzt_your-token-here \
  -- npx -y @asadullokhn/teztun-mcp

Cursor / Zed / Windsurf

每个编辑器都有一个 MCP 配置文件（如 ~/.cursor/mcp.json）。配置块格式与上面的 Claude Desktop 示例相同。

获取服务令牌

在 app.teztun.uz 注册，然后创建服务令牌。Max 套餐（每年 $10）的令牌永不过期——推荐用于 AI 编辑器。

软件包的工作方式

此软件包是一个轻量级启动器。它会按以下顺序尝试：

1. 如果已安装 TezTun CLI（teztun），则运行 teztun mcp。
2. 如果 Docker 可用，则运行 docker run --rm -i -e TEZTUN_TOKEN asadullokhn/teztun:latest mcp。
3. 否则会报错并显示安装说明。

不捆绑二进制文件，也没有安装后副作用。MCP 服务本身是来自 teztun.uz/download 的 Go 二进制文件，或 Docker Hub 上的 asadullokhn/teztun 镜像。

提供的工具

工具	功能
get_account	当前用户（套餐、状态）
list_tunnels	活跃隧道及其公开 URL
list_subdomains	已预留的子域名
reserve_subdomain(name)	预留新的子域名（受套餐限制）
release_subdomain(id)	释放已预留的子域名（破坏性操作）
list_custom_domains	Max 套餐中的自定义域名
list_service_tokens	用户创建的服务令牌
create_service_token(name, expiry_seconds?, expire_never?)	创建令牌
revoke_service_token(id)	撤销服务令牌（破坏性操作）

链接

• 产品：https://teztun.uz
• 控制面板：https://app.teztun.uz
• 文档：https://teztun.uz/docs/mcp-server
• API 参考：https://teztun.uz/docs/api
• Docker 镜像：asadullokhn/teztun
• 支持：[email protected]

许可证

MIT。仅包含启动器——它启动的 MCP 服务二进制文件是官方 TezTun 客户端。