tunnels.io

tunnels-mcp

tunnels.io 用の MCP サーバーです。

ローカルで実行され、CLI トークンを 1 つ保持し、アカウントへの読み取りアクセスをアシスタントに提供します。トンネルを開くこともできます。

インストール

リリースページからお使いのプラットフォーム用のバイナリをダウンロードするか、ビルドしてください。

go install github.com/tunnels-io/tunnels-mcp/cmd/[email protected]

Claude Desktop など、MCP バンドルに対応したクライアントでは、同じページから tunnels-mcp-<version>.mcpb をインストールできます。トークンの入力を求められます。

サーバーは MCP Registry に io.github.tunnels-io/tunnels-mcp として登録されています。

トークン

t を作成してください：tunnels.io/account/tokens。必要な権限にチェックを入れます。

権限を省略しても、ツールが使えなくなるわけではありません。サーバーは起動時にトークンの権限を読み取り、動作するツールのみを一覧表示します。

以前のすべてにアクセスできるトークン（*）は、請求、ドメイン、クラウドアプリを除くすべてで使えます。この 3 つのサービスは * を拒否するため、そのようなトークンではサーバーにそれらのツールが表示されません。これらを利用するには、上記のページでトークンを作成してください。

TUNNELS_TOKEN     required, starts tnl_
TUNNELS_API       default https://tunnels.io
TUNNELS_CLI       default "tunnels" on PATH
TUNNELS_INSPECT   unset. The CLI inspector is off; set an address to enable it.

~/.config/tunnels/mcp.json に設定ファイルを作成しても使えます。

{ "token": "tnl_..." }

環境変数の設定が優先されます。

クライアントの設定

{
  "mcpServers": {
    "tunnels": {
      "command": "tunnels-mcp",
      "env": { "TUNNELS_TOKEN": "tnl_..." }
    }
  }
}

ツール

ツール	権限
list_tunnels	tunnels:read
get_usage	usage:read
get_metrics	usage:read
get_account	account:read
list_tokens	tokens:read
list_invoices	billing:read
list_domains	registrar:read
list_notifications	notifications:read
list_cloud_apps	cloud:read
start_tunnel	なし
stop_tunnel	なし

最後の 2 つを除き、読み取り専用です。最後の 2 つは tunnels CLI を呼び出すため、PATH に含まれている必要があります。プランの変更、ドメインの購入、デプロイを行うツールはありません。

start_tunnel は http（デフォルト。公開 URL では HTTPS として提供されます）または tcp を受け取ります。

トークンの取り扱い

トークンは Bearer ヘッダーで tunnels.io に送信され、環境変数を通じて CLI に渡されます。コマンドラインに渡されることはありません。ログにも、ツールの結果にも出力されません。

エラー本文は表示前にマスキングされます。

サーバーが接続するのは tunnels.io のみです。

ビルド

make check
make build

依存関係はありません。

リリース

v0.0.2 のようなタグをプッシュしてください。release ワークフローが 6 つのバイナリと MCPB バンドルをビルドし、GitHub リリースを作成して、server.json を MCP Registry に公開します。同じファイルをローカルでビルドするには、macOS で次のコマンドを実行してください。

make release V=0.0.2

ライセンス

MIT です。LICENSE を参照してください。