文档菜单

入门

代理基础

代理API

响应缓存

Litport API

MCP服务器

面向AI助手的MCP服务器

通过Model Context Protocol（MCP）服务器，将AI编程助手连接到您的Litport账户。助手可以列出您的代理令牌、读取用量和扣费、查询代理池可定位的国家，并组装可用的代理连接字符串，无需您先编写HTTP客户端。

服务器无法创建令牌、购买或取消套餐，也无法使用余额。对于位置可更改的令牌，它可以更改其位置、轮换间隔或IP；它还可以更改套餐的IP白名单，详见下文。不支持IPv6请求；请联系客服。

安装#

服务器运行在您自己的机器上，通过HTTPS与本站通信。在设置中创建API密钥，然后将服务器添加到您的MCP主机。

Claude Code：

claude mcp add litport --env LITPORT_API_KEY=lit_your_key_here -- npx -y @litportnet/litport-mcp

Codex：

codex mcp add litport --env LITPORT_API_KEY=lit_your_key_here -- npx -y @litportnet/litport-mcp

这会把服务器写入~/.codex/config.toml。也可以手动添加该配置块：

[mcp_servers.litport]
command = "npx"
args = ["-y", "@litportnet/litport-mcp"]

[mcp_servers.litport.env]
LITPORT_API_KEY = "lit_your_key_here"

使用codex mcp list检查，使用codex mcp get litport查看单个条目，使用codex mcp remove litport移除。

Claude Desktop、Cursor、Windsurf以及其他启动本地进程的主机使用配置块：

{
  "mcpServers": {
    "litport": {
      "command": "npx",
      "args": ["-y", "@litportnet/litport-mcp"],
      "env": { "LITPORT_API_KEY": "lit_your_key_here" }
    }
  }
}

环境变量#

变量 默认值 作用
LITPORT_API_KEY 未设置 来自设置页面的API密钥。不是代理用户名或密码。没有它时，只会加载客服支持和文档工具，客服支持问题将进入访客对话。
LITPORT_API_URL https://litport.net 覆盖API源站地址。
LITPORT_MCP_REVEAL_CREDENTIALS 未设置 设为1可在list_tokens输出中直接包含代理密码。

工具#

工具 功能 写入
list_tokens 列出您的令牌及其类型、状态和入口信息。 否
get_token_credentials 单个令牌的完整凭证。 否
get_token_usage 单个令牌的流量和扣费明细。 否
get_token_location 读取位置可更改的令牌已保存的位置和实际生效的位置。 否
list_location_options 列出当前可用于令牌下一个位置字段的值。 否
set_token_location 更改令牌的位置（仅限位置可更改的令牌）。 是
set_rotation 更改轮换令牌的轮换间隔。 是
get_new_ip 在同一位置获取新IP（仅限静态数据中心/ISP）。 是
list_packages 列出您拥有的套餐及其状态、产品、附加项和令牌ID。 否
get_package 读取单个套餐。 否
get_allowed_ips 读取套餐的IP白名单。 否
set_allowed_ips 设置套餐的完整IP白名单。 是
add_allowed_ip 向套餐的IP白名单添加一个IP。 是
remove_allowed_ip 从套餐的IP白名单移除一个IP。 是
list_pools 可选择的按流量计费代理池，包含实际每GB价格、端口、UDP支持（udp）、符合条件的节点和地理层级。 否
list_targeting_options 代理池可定位的国家、州/省和城市。 否
get_balance 余额、预留单位和方案。 否
build_proxy_url 组装带有地理位置和会话参数的可用代理URL。 否
explain_proxy_error 将代理错误码转换为重试决策。 否
search_docs 查找涵盖某个主题的文档页面。 否
get_doc 以Markdown格式读取文档页面。 否
contact_support 向Litport客服提问。使用API密钥时，消息进入您账户的对话；没有密钥时，会开始一个访客对话，并需要您的邮箱。 是
get_support_replies 读取客服对话中的新消息。 否
reply_to_support 向客服对话添加一条消息。 是

每个会执行写入的账户工具与每个读取工具使用同一个API密钥；没有单独的写入权限范围。客服支持工具有无密钥均可使用：见联系客服。创建或删除令牌，以及购买、续费或取消套餐，仍需在控制台中进行。

explain_proxy_error根据随npm包一起发布的代理错误参考副本作答，因此诊断故障不产生任何费用，也不消耗速率限制额度。

代理密码的处理方式#

list_tokens是浏览操作，因此默认会隐藏密码：每个令牌返回password: null和passwordSet: true。这样，列出大量令牌时不会把每个密码都放入助手的上下文，进而进入您的聊天记录。

没有隐瞒任何信息。get_token_credentials和build_proxy_url都会为您指定的单个令牌返回真实密码。如果希望在列表中直接显示凭证，请设置LITPORT_MCP_REVEAL_CREDENTIALS=1。

build_proxy_url还接受credentialStyle: "env"，此时返回的URL中以$LITPORT_PROXY_PASSWORD代替密码，并将该值单独返回。当助手正在编写您打算保留的脚本时使用它，这样密码就不会出现在您的源代码中。

构造连接字符串#

build_proxy_url在返回任何内容之前，会先应用PPG代理参数中的规则，因此格式错误的国家slug或超出范围的会话时长会被立即报告，而不是等请求被拒绝之后才发现。

对于按流量计费令牌，它会把代理池、地理位置和会话片段追加到用户名，并选择与所选协议对应的端口。已保存代理池的令牌不接受代理池参数，冲突的参数会被拒绝。未保存代理池的令牌必须提供代理池参数，因为价格由代理池决定。

不限流量令牌连接到分配给它的唯一端点，因此既不接受代理池参数，也不接受地理位置或会话参数。

常见问题#

它能创建代理或花费我的余额吗？不能。部分工具会执行写入（见上表：位置可更改的令牌的位置、轮换或新IP，以及套餐的IP白名单），但没有任何一个可以创建或删除令牌，或转移资金。创建令牌和购买流量仍在控制台中进行。

启动时需要我的代理密码吗？不需要。它使用API密钥进行认证，API密钥与代理凭证是分开的。代理用户名和密码用作API密钥时会被拒绝。

哪些助手可以使用它？任何能够启动本地进程的MCP主机，包括Claude Code、Codex、Claude Desktop、Cursor、Windsurf和Zed。

我的密钥会发送给模型吗？不会。密钥只保留在您机器上的服务器进程中，仅用于发往本站的Authorization请求头。

达到速率限制会怎样？API对每个密钥每分钟允许固定数量的请求，超出后返回429。有三个工具完全不需要API密钥（explain_proxy_error、search_docs和get_doc），因此在触及速率限制时它们仍可正常使用。后两个仍会从本站获取文档页面。

为什么令牌没有显示主机？当不限流量令牌指向的节点已不再提供服务时，它会报告ingress.status: "hub-unavailable"。令牌自身的status只会是active、expired或disabled。请联系客服，将节点不可用的令牌迁移到当前可用的节点。

这些工具调用的API记录在Litport API，其错误码见API错误。机器可读规范位于/docs/openapi.json。

MarkdownOpenAPI