teztun

@asadullokhn/teztun-mcp

公式 TezTun MCP サーバーです。Claude Desktop／Claude Code／Cursor／Zed／Windsurf／その他あらゆるModel Context Protocolクライアント向けの、インストールが1回で済む npm パッケージです。

チャットを通じて、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. それ以外の場合は、インストール手順を示すエラーを返します。

バンドルされたバイナリはなく、postinstall による副作用もありません。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 クライアントです。