Localtonet MCP 服务器
本页内容 9 个章节
Localtonet MCP 服务器让支持 Model Context Protocol 的 AI 助手(例如 Claude 或 Cursor)用自然语言管理你的账户:列出、创建、启动、停止和配置隧道,以及管理 AuthToken、令牌组、服务器和 SSO 提供商。
它是什么,以及它不是什么 #
- 本页所说的 MCP 服务器由 Localtonet 运行,地址为
https://localtonet.com/mcp。它的工具作用于你的 Localtonet 账户,与 REST API 的作用方式相同。 - MCP 网关是一种隧道类型。它为运行在你自己设备上的 MCP 服务器提供一个公共地址。用它来发布你自己的工具,而不是管理 Localtonet。
连接详情 #
| 设置项 | 值 |
|---|---|
| 端点 | https://localtonet.com/mcp |
| 传输方式 | Streamable HTTP |
| 认证 | 把你的 API 密钥作为 Bearer 令牌:Authorization: Bearer <YOUR_API_KEY> |
| 服务器信息 | localtonet.com/mcp-info(JSON)以及位于 https://localtonet.com/.well-known/mcp-server-card 的服务器卡片 |
开始之前 #
- 一个能通过 Streamable HTTP 连接远程服务器并发送自定义
Authorization请求头的 MCP 客户端。 - 你的 API 密钥。打开控制台,在 API 密钥卡片中使用复制。参见账户与安全。
- 如需处理隧道:一台已连接 Localtonet 客户端的设备,这样助手才有可用于创建隧道的 AuthToken。
连接你的 MCP 客户端 #
-
把服务器添加到客户端 #
大多数 MCP 客户端以 URL 加请求头的方式接收远程服务器。常见的形式如下:
MCP 客户端配置{ "mcpServers": { "localtonet": { "type": "http", "url": "https://localtonet.com/mcp", "headers": { "Authorization": "Bearer <YOUR_API_KEY>" } } } }不同客户端的文件名和具体的键名各不相同。请查看你所用客户端的文档,了解在哪里配置远程 MCP 服务器,并使用上面的 URL 和请求头。
-
检查连接 #
重新加载客户端。Localtonet 的工具应该会出现在它的工具列表中。先问一个无害的问题,例如:
提示词List my Localtonet tunnels and tell me which ones are running. -
创建隧道 #
描述你想要的结果。例如:
提示词Create an HTTP tunnel with a random subdomain for port 3000 on my device "laptop", then start it and give me the URL.助手会遵循服务器规定的工作流程:查找设备的 AuthToken,选择服务器,调用对应的创建工具,并启动隧道,因为新创建的隧道不会自动运行。
工具 #
下面的工具名称就是你的客户端显示的名称。失败的工具会返回以 Error: 开头的消息。
隧道 #
| 用途 | 工具 |
|---|---|
| 查看 | GetTunnels, GetTunnel, GetTunnelRequestLogs |
| 创建 | CreateHttpRandomSubDomain, CreateHttpCustomSubDomain, CreateHttpCustomDomain, CreateTcpUdpTunnel, CreateProxyTunnel, CreateProxyTunnelWithDetail, CreateSharedProxyTunnel |
| 运行 | StartTunnel, StopTunnel, DeleteTunnel |
| 更改 | UpdateTunnelTitle, UpdateTunnelLocalIp, UpdateTunnelLocalPort, ToggleTunnelPortReserved, ToggleTunnelLegacyConnect, ChangeProxyProtocolType |
| 批量 | BulkCreateHttpRandomSubDomain, BulkCreateHttpCustomSubDomain, BulkCreateHttpCustomDomain, BulkCreateTcpUdpTunnel, BulkCreateProxyTunnel, BulkCreateProxyTunnelWithDetail, BulkCreateSharedProxyTunnel, BulkStartTunnels, BulkStopTunnels, BulkDeleteTunnels, BulkChangeProxyProtocolType |
隧道配置 #
| 设置项 | 工具 |
|---|---|
| IP 限制 | GetIpRestrictions, AddIpRestriction, SetIpRestrictionMode, DeleteIpRestriction, DeleteAllIpRestrictions |
| 访问控制 | GetAccessControls, AddAccessControl, SetAccessControlMode, DeleteAccessControl, DeleteAllAccessControls |
| 请求头与认证 | GetTunnelHeaders, SetTunnelHeaders, GetTunnelAuthentication, SetTunnelAuthentication |
| 到期与限制 | GetTunnelExpiration, SetTunnelExpiration, GetTunnelRateLimit, SetTunnelRateLimit, GetTunnelBandwidthLimit, SetTunnelBandwidthLimit, GetTunnelBandwidthUsage, ResetTunnelBandwidthUsage |
| 服务器与端口 | GetTunnelServerPort, SetTunnelServerPort, GetTunnelServer, SetTunnelServer |
| 参数与备注 | GetTunnelArguments, SetTunnelArguments, GetTunnelNote, SetTunnelNote |
| 轮换代理客户端与令牌组 | GetSharedProxyClients, AddSharedProxyClient, UpdateSharedProxyClient, DeleteSharedProxyClient, GetTunnelTokenGroups, SetTunnelTokenGroups |
| 高级设置 | GetAdvancedTunnelSettings, GetTunnelIpv4Only, SetTunnelIpv4Only, GetTunnelWifiSplit, SetTunnelWifiSplit, SetTunnelSslStream, GetTunnelProxyProtocol, SetTunnelProxyProtocol, GetTunnelPassThrough, SetTunnelPassThrough, GetTunnelHttpsOnly, SetTunnelHttpsOnly, GetTunnelHttp3, SetTunnelHttp3, GetTunnelFilePath, SetTunnelFilePath, GetTunnelHostHeader, SetTunnelHostHeader, GetTunnelPathRewrite, SetTunnelPathRewrite, GetTunnelUpstreamProxy, SetTunnelUpstreamProxy, GetTunnelVless, SetTunnelVless |
这些设置的作用见设置参考。
AuthToken 与令牌组 #
| 用途 | 工具 |
|---|---|
| AuthToken | GetAuthTokens, GetAllAuthTokens, GetAuthToken, CreateAuthToken, DeleteAuthToken, GetTunnelsByAuthToken, GetIpHistoryByAuthToken, GetArgumentsByAuthToken, SetArgumentsForAuthToken |
| 飞行模式与更换 IP | GetAirplaneModeSettings, SetAirplaneModeSettings, AddChangeIpLink, DeleteChangeIpLink, AddRestartDeviceLink, DeleteRestartDeviceLink |
| 令牌组 | GetTokenGroups, GetTokenGroup, CreateTokenGroup, DeleteTokenGroup, AddAuthTokenToGroup, RemoveAuthTokenFromGroup |
服务器与 SSO 提供商 #
| 用途 | 工具 |
|---|---|
| 服务器 | GetAvailableServers |
| SSO 提供商 | GetSsoProviders, GetSsoProviderDefaultEndpoints, SaveSsoProvider, DeleteSsoProvider, GetSsoProvidersForTunnel, SetSsoProvidersForTunnel |
代理隧道上的 VPN 访问 #
GetVpnAccessDevices、CreateVpnAccessDevice、GetVpnAccessDeviceConfig、GetVpnAccessDeviceCredentials、RegenerateVpnAccessDevice、DeleteVpnAccessDevice。这些工具用于管理代理隧道上的 WireGuard 和 OpenVPN 设备。每台设备都有自己的配置,其全部流量都通过代理发出。
设备 #
| 工具 | 作用 |
|---|---|
ListDevices | 列出在我的设备下与你的账户配对的电脑,包括每台是否在线,以及它的 CPU、内存和磁盘使用情况。 |
GetDeviceMetrics | 返回某一台设备最新的 CPU、内存、磁盘和运行时间数据。 |
RunDeviceCommand | 在设备上运行一条 shell 命令,并返回其输出和退出码。它最多等待你指定的超时时间,范围为 1 到 120 秒,默认 30 秒。 |
RunDeviceCommand 需要的不只是 API 密钥:它还需要一个设备访问密钥(以 ltd_ 开头),你要在我的设备下为该设备创建它。参见设备终端。每次运行都会连同时间和 IP 地址出现在该设备的连接历史中;命令本身不会被保存。
限制 #
- 对 MCP 服务器的请求会受到速率限制,并与你的 API 密钥的 API 请求合并计算。收到
429回复表示:请等待,然后重试。 - 批量工具最多接受 100 个条目的列表。
安全 #
助手以你的 API 密钥行事。它的工具可以创建、停止和删除隧道,删除 AuthToken 和令牌组,以及更改访问规则,而 Localtonet 一侧没有确认步骤。
- 请在你的 MCP 客户端中开启工具调用确认,至少对以
Delete、BulkDelete、Stop和Set开头的工具开启。 - 只把
RunDeviceCommand所需的设备访问密钥交给你同样愿意让它在那台电脑上使用终端的助手。命令由设备的默认 shell 运行。 - 请把客户端配置文件当作机密:其中包含你的 API 密钥。不要把它提交到代码仓库。
- 如果密钥可能已经泄露,请在控制台的 API 密钥卡片中选择更换。这会创建新密钥并使旧密钥失效;然后请更新你的 MCP 客户端。
- 如果 API 密钥是在团队控制台中复制的,助手只会列出该团队中属于你的 AuthToken 和隧道。参见团队管理。
故障排除 #
客户端报告 401,或 “API key is required. Provide Authorization: Bearer <apikey>”
请求中没有有效的 Authorization 请求头。请检查客户端是否为此服务器发送了自定义请求头,值是否为 Bearer、一个空格,然后是密钥,以及自你复制之后密钥是否没有在控制台中被更换。
助手说某个工具返回了 “Error: …”
这是 Localtonet 的回复,不是连接问题。Error: 后面的文字说明了被拒绝的原因,例如缺少 AuthToken 或达到套餐限制。请解决该原因,而不是让助手反复重试。
隧道已创建,但没有响应
请让助手启动它。在调用 StartTunnel 之前,新隧道处于停止状态,并且设备上的 Localtonet 客户端必须已连接。
我的客户端中缺少一些工具
有些客户端会限制工具数量,或要求你逐个启用。请在客户端设置中启用你需要的 Localtonet 工具。