free-proxy-mcp

Litport 免费代理 MCP 服务

一个本地 stdio Model Context Protocol 服务，为 MCP 客户端（Claude Desktop、Claude Code 或任何其他兼容 MCP 的 Agent）提供三个有限的只读工具，用于访问 Litport 公开的免费代理快照：列出经过验证的 HTTP、SOCKS4 和 SOCKS5 代理，挑选排名最高的代理，并概述当前快照。它不会转发流量，不接受工具调用方提供的任意 URL，也不提供写入或产生副作用的工具；它只是对 @litportnet/free-proxy-sdk 的轻量封装。

安装 / 与 Claude Desktop、Claude Code 及其他 MCP 客户端配合使用

将以下内容添加到客户端的 MCP 服务配置中（Claude Desktop 使用 claude_desktop_config.json；Claude Code 使用 .mcp.json 或 claude mcp add）：

{
  "mcpServers": {
    "free-proxy": {
      "command": "npx",
      "args": ["-y", "@litportnet/free-proxy-mcp"]
    }
  }
}

只需确保已安装 Node.js 20+，无需额外安装；npx 会按需获取并运行此软件包。也可以显式安装：

npm install -g @litportnet/free-proxy-mcp

工具

所有三个工具均为只读，并使用相同的底层筛选条件。country 是两位 ISO 3166-1 alpha-2 国家代码（不区分大小写）。checkedWithinMin 将结果限制为最近 1-1440 分钟内检查过的代理。

工具	描述	输入
list_proxies	列出符合筛选条件的已验证免费代理。	protocol（http|socks4|socks5）、country、anonymity（transparent|anonymous|elite|unknown）、https（布尔值）、maxLatencyMs（整数 ≥ 0）、minUptime7d（整数 0-100）、minChecks7d（整数 ≥ 0）、checkedWithinMin（整数 1-1440，默认 30）、limit（整数 1-50，默认 10）
pick_best_proxies	返回符合筛选条件且排名最高的代理。	count（整数 1-25，默认 5），以及与 list_proxies 相同的筛选条件，但不包括 limit
proxy_snapshot_stats	概述当前代理快照。	checkedWithinMin（整数 1-1440，默认 30）、protocol、country

list_proxies 和 pick_best_proxies 会返回 count，以及包含标准化记录的 proxies 数组；这些记录与 SDK 返回的完全一致。proxy_snapshot_stats 会返回匹配总数、按协议和匿名级别统计的数量、数量最多的前 10 个国家、支持 HTTPS 的匹配代理占比、报告了延迟的记录中的延迟最小值／中位数／p90／最大值、七日正常运行时间已知的记录数，以及最新和最早的 lastChecked 时间戳。每个响应都包含 disclaimer 字段。底层 SDK 的错误（筛选条件无效、请求超时、快照格式错误或已过期）会以 { isError: true, content: [...] } 的形式返回，而不是抛出；响应中绝不会包含堆栈跟踪。

环境变量

变量	默认值	用途
LITPORT_FREE_PROXY_API_URL	SDK 内置的快照 URL	快照端点的绝对 http:// 或 https:// URL。服务会验证此值；如果设置为其他值，启动时会退出并显示明确错误。
LITPORT_FREE_PROXY_TIMEOUT_MS	10000	传递给 SDK 客户端的每次请求超时时间（毫秒）。

测试

npm install
npm test

npm test 会通过 node --test 运行 test/*.test.mjs：进程内单元测试使用注入的 @litportnet/free-proxy-sdk 客户端，通过 MCP SDK 的内存传输驱动服务；端到端测试则会针对本地 HTTP 测试服务器，通过 stdio 启动服务；此外还有一个回归测试，会像 npx 一样通过 bin 符号链接启动服务。

资源

• 免费代理列表
• API 文档
• SDK 源码

免费代理仅供测试使用。切勿通过它们传输凭据、Cookie、支付数据或私人数据。