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 分