Teztun

io.github.asadullokhn由 GitHub 账号 asadullokhn 发布v1.0.1更新于 Oct 24, 2026

Manage TezTun tunnels, subdomains, and service tokens from any MCP-compatible AI client.

概览

AI 生成的概览

TezTun 官方 MCP 服务器,让 AI 客户端查看隧道与子域名,并管理 TezTun 隧道基础设施的服务令牌。

可以做什么
  • 查看账户与隧道:读取当前用户的套餐与状态、带公网地址的活跃隧道、已保留的子域名以及自定义域名
  • 管理子域名:保留新的子域名或释放已有子域名
  • 管理服务令牌:列出已签发的令牌、创建带可选有效期的令牌,或吊销令牌
适用场景
适合在使用 TezTun 隧道时,通过对话查看 webhook 或公网地址、保留或释放子域名,以及签发或吊销服务令牌,而不必打开控制台。
运行要求
通过 npx 在本地以轻量启动器方式运行,需要已安装 TezTun CLI 或可用 Docker,否则会报错并给出安装说明。需要 TezTun 账户,并通过 TEZTUN_TOKEN 环境变量提供服务令牌。部分功能受套餐限制,例如自定义域名和永不过期的令牌需要 Max 套餐。
安装前请注意
该服务器持有可签发和吊销其他令牌的 TezTun 服务令牌,应视为机密。释放子域名和吊销服务令牌属于破坏性操作,无法在对话中撤销。保留子域名和创建令牌可能依赖付费套餐。启动器可能会拉取并运行 Docker Hub 上的镜像。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Teztun,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@asadullokhn/teztun-mcp

Official TezTun MCP server, as a single-install npm package for Claude Desktop / Claude Code / Cursor / Zed / Windsurf / any Model Context Protocol client.

Lets your AI editor manage your TezTun infrastructure through chat:

  • "What's my current webhook URL?" → list_tunnels
  • "Reserve a subdomain called demo" → reserve_subdomain
  • "Mint a service token for prod-docker, never expires" → create_service_token
  • "Revoke the staging-ci token" → revoke_service_token

Install & configure

You don't install this manually — MCP clients run it via npx. Pick your client:

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Claude Code

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

Cursor / Zed / Windsurf

Each editor has an MCP config file (~/.cursor/mcp.json, etc.). The block shape is the same as the Claude Desktop example above.

Get a service token

Sign up at app.teztun.uz, then mint a service token. On the Max plan ($10/year) tokens never expire — recommended for AI editor use.

How the package works

This package is a thin launcher. It tries, in order:

  1. If the TezTun CLI (teztun) is installed, it runs teztun mcp.
  2. If Docker is available, it runs docker run --rm -i -e TEZTUN_TOKEN asadullokhn/teztun:latest mcp.
  3. Otherwise it errors with install instructions.

No bundled binaries, no postinstall side effects. The MCP server itself is the Go binary from teztun.uz/download, or the asadullokhn/teztun image on Docker Hub.

Exposed tools

ToolWhat it does
get_accountCurrent user (plan, status)
list_tunnelsActive tunnels with their public URLs
list_subdomainsReserved subdomains
reserve_subdomain(name)Reserve a new subdomain (plan-gated)
release_subdomain(id)Release a reserved subdomain (destructive)
list_custom_domainsCustom domains on the Max plan
list_service_tokensService tokens the user has minted
create_service_token(name, expiry_seconds?, expire_never?)Mint a token
revoke_service_token(id)Revoke a service token (destructive)

Links

License

MIT. Launcher only — the MCP server binary it spawns is the official TezTun client.

来源:README.md,提交 f78b226

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分