tunnels.io

tunnels-mcp

tunnels.io 的 MCP 服务。

它在本地运行，持有一个 CLI 令牌，并为助手提供账户的只读访问权限。它也可以打开隧道。

安装

从发布页面下载适用于你平台的二进制文件，或自行构建：

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

Claude Desktop 等支持 MCP bundle 的客户端，可以从同一页面安装 tunnels-mcp-<version>.mcpb。安装时会要求提供令牌。

该服务已在 MCP Registry 中注册，名称为 io.github.tunnels-io/tunnels-mcp。

令牌

在 tunnels.io/account/tokens 创建令牌。勾选你需要的权限。

不授予某项权限并不意味着工具不可用。服务会在启动时读取令牌的权限，并仅列出可用的工具。

旧版全权限令牌（*）适用于所有功能，但账单、域名和云应用除外。这三项服务不接受 *，因此使用此类令牌时，服务不会列出相应工具。要使用这些功能，请在上面的页面创建令牌。

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	无

除最后两个工具外，其他都只读。最后两个工具会调用 tunnels CLI，因此它必须位于 PATH 中。没有任何工具会更改套餐、购买域名或部署任何内容。

start_tunnel 接受 http（默认值，通过 HTTPS 提供公开 URL）或 tcp。

令牌处理

令牌会通过 Bearer 标头发送给 tunnels.io，并通过环境变量传递给 CLI。绝不会放在命令行中，也绝不会写入日志或工具结果。

错误响应正文在显示前会经过脱敏处理。

该服务只会联系 tunnels.io，不会联系其他任何地方。

构建

make check
make build

无依赖项。

发布

推送一个标签，例如 v0.0.2。release 工作流会构建六个二进制文件和 MCPB bundle、创建 GitHub 发布，并将 server.json 发布到 MCP Registry。要在 macOS 上本地构建相同文件：

make release V=0.0.2

许可证

MIT。请参阅 LICENSE。