English Français العربية

io.github.asadullokhn/teztun

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @asadullokhn/teztun-mcp
Claude Code 
claude mcp add teztun -e 'TEZTUN_TOKEN=<your teztun_token>' -- npx -y @asadullokhn/teztun-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "teztun": {
            "command": "npx",
            "args": [
                "-y",
                "@asadullokhn/teztun-mcp@1.0.1"
            ],
            "env": {
                "TEZTUN_TOKEN": "<your teztun_token>"
            }
        }
    }
}

متغيرات البيئة

  • TEZTUN_TOKEN إلزامي سري A TezTun service token (starts with tzt_). Mint one at https://app.teztun.uz/tokens.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @asadullokhn/teztun-mcp
  2. Install & configure
  3. Get a service token
  4. How the package works
  5. Exposed tools
  6. Links
  7. License

@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):

{
  "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

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)

License

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

الأسئلة الشائعة

ما هو io.github.asadullokhn/teztun؟

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

كيف أثبّت io.github.asadullokhn/teztun؟

يعمل على جهازك. في Claude Code: claude mcp add teztun -e 'TEZTUN_TOKEN=<your teztun_token>' -- npx -y @asadullokhn/teztun-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.asadullokhn/teztun إلى مفتاح API؟

نعم. يتطلب TEZTUN_TOKEN، وتضبطها في إعداداته.

هل io.github.asadullokhn/teztun مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.asadullokhn/teztun؟

ينشره asadullokhn. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.